          ______   ___    ___
         /\  _  \ /\_ \  /\_ \
         \ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___ 
          \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\
           \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \
            \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
             \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
                                            /\____/
                                            \_/__/
 
       Fichero ReadMe MPW
 
       Por Ronaldo H. Yamada
  
       Vase readme.txt para un punto de vista ms general.
 
 
====================================
============ Notas MPW =============
====================================

   No est garantizado que este port funcione en cualquier mquina. Me
   gustara saber qu tal funciona esto.

   Estado: el mnimo para funcionar, esta versin es mucho ms joven que las
   dems, por lo que puede ser la que tenga ms fallos. Consulte el fichero
   todo.txt para ver una lista de las cosas que faltan o funcionan mal.


============================================
============ Hardware requerido ============
============================================

   - Un Power Macintosh


============================================
============ Software requerido ============
============================================

   - MPW-GM 3.4.4
   - Universal Headers 3.3.1
   - DrawSprocketSDK 1.7*
   - SoundManager 3.0*
   - MacOS 8.1*

   Escrib el port de Allegro con estas versiones, no puedo determinar si
   funcionar con otras, deber probar, y me gustara oir qu tal le va.

   MPW-GM puede ser obtenido directamente de Apple. <ftp://ftp.apple.com/
   developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM_Images/>
   Una versin antigua de las cabeceras est includa con MPW, pero yo uso
   un nuevo conjunto de
   <ftp://ftp.apple.com/developer/Development_Kits/UniversalHeaders3.3.1.img.bin>
   DrawSprocketSDK y SoundManager pueden obtenerse directamente de Apple.

   * los usuarios finales pueden necesitar este software.



============================================
============ Instalando Allegro ============
============================================

   Esto es una distribucin de cdigo fuente, por lo que necesitar compilar
   Allegro antes de usarlo. Para realizar esto deber:

   Hacer que el directorio actual sea el directorio principal de Allegro (el
   cual contiene el fichero fixmpw.sh). Si lanza MPW usando este fichero,
   entonces probablemente ya lo haya hecho.

   En la ventana Worksheet teclee fixmpw.sh seguido de Command-Return o
   Enter. La librera estar lista para ser usada. Instale una versin de
   depuracin de la librera. Sea paciente, esto puede tardar mucho tiempo.
   Puede ser necesario que salga del Shell MPW antes de usar la librera.

   

=======================================================
============ Personalizando la instalacin ============
=======================================================

	Opcin      Accin
	all         compilar e instalar todo
	alld        compilar e instalar slo la librera
	tests       compilar e instalar tests y librera
	examples    compilar e instalar ejemplos y librera
	docs        compilar e instalar documentacin en formato html

	ejemplo:

   	fixmpw.sh alld tests <enter>



========================================
============ Usando Allegro ============
========================================

   Allegro podra trabajar como una librera compartida, por lo que para
   futura compatibilidad necesita definir el smbolo ALLEGRO_STATICLINK
   antes de inclur los ficheros de cabecera de Allegro.

   No olvide que necesita usar la macro END_OF_MAIN() justo tras su funcin
   main().

   Todas las funciones, variables y estructuras de Allegro estn definidas en
   allegro.h. Debe inclur esto en sus programas:

   <Allegro.h>

   Pero para no causar polucin con la carpeta principal de includes, reside
   en la carpeta de Allegro, que deber activar en Interfaces&Libraries para
   poder compilar.
   
   -i {Allegro} (o Includes = -i {Allegro} en makefiles automticos)

   Asegrese de que enlaza con las siguientes libreras:

	"{Allegro}allegro.x"                -  librera esttica de allegro
	"{SharedLibraries}InterfaceLib"
	"{SharedLibraries}StdCLib"
	"{SharedLibraries}MathLib"
	"{SharedLibraries}DrawSprocketLib"
	"{PPCLibraries}StdCRuntime.o"
	"{PPCLibraries}PPCCRuntime.o"
	"{PPCLibraries}PPCToolLibs.o"

   Siempre debe decirle a Allegro cul es el punto de entrada en el enlazado,
   por lo que incluya esta opcin:
   
   -m MacEntry

   De otro modo podra cascar, esto puede cambiar en el futuro. Incluya
   tambin el fichero de recursos:

   "{Allegro}allegro.r"      - recursos necesarios para que funcione allegro

  	Rez {Allegro}allegro.r -o {progname} -i {Allegro} -append

   Mire los ejemplos en la carpeta tests:mac.



===============================================
============ Desinstalando Allegro ============
===============================================

   Borre la carpeta Allegro en Interfaces&Lubrarues y el script
   "SetAllegro" de la carpeta Startup.
   
