______   ___    ___
         /\  _  \ /\_ \  /\_ \
         \ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___ 
          \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\
           \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \
            \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
             \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
                                            /\____/
                                            \_/__/
 
       Fichero ReadMe MPW
 
       Por Ronaldo H. Yamada
  
       Véase readme.txt para un punto de vista más general.
 
 
====================================
============ Notas MPW =============
====================================

   No está garantizado que este port funcione en cualquier máquina. Me
   gustaría saber qué tal funciona esto.

   Estado: el mínimo para funcionar, esta versión es mucho más joven que las
   demás, por lo que puede ser la que tenga más 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 gustaría 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 versión antigua de las cabeceras está incluída 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 distribución de código 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 librería estará lista para ser usada. Instale una versión de
   depuración de la librería. Sea paciente, esto puede tardar mucho tiempo.
   Puede ser necesario que salga del Shell MPW antes de usar la librería.

   

=======================================================
============ Personalizando la instalación ============
=======================================================

	Opción      Acción
	all         compilar e instalar todo
	alld        compilar e instalar sólo la librería
	tests       compilar e instalar tests y librería
	examples    compilar e instalar ejemplos y librería
	docs        compilar e instalar documentación en formato html

	ejemplo:

   	fixmpw.sh alld tests <enter>



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

   Allegro podría trabajar como una librería compartida, por lo que para
   futura compatibilidad necesita definir el símbolo ALLEGRO_STATICLINK
   antes de incluír los ficheros de cabecera de Allegro.

   No olvide que necesita usar la macro END_OF_MAIN() justo tras su función
   main().

   Todas las funciones, variables y estructuras de Allegro están definidas en
   allegro.h. Debe incluír esto en sus programas:

   <Allegro.h>

   Pero para no causar polución 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 automáticos)

   Asegúrese de que enlaza con las siguientes librerías:

	"{Allegro}allegro.x"                -  librería estática de allegro
	"{SharedLibraries}InterfaceLib"
	"{SharedLibraries}StdCLib"
	"{SharedLibraries}MathLib"
	"{SharedLibraries}DrawSprocketLib"
	"{PPCLibraries}StdCRuntime.o"
	"{PPCLibraries}PPCCRuntime.o"
	"{PPCLibraries}PPCToolLibs.o"

   Siempre debe decirle a Allegro cuál es el punto de entrada en el enlazado,
   por lo que incluya esta opción:
   
   -m MacEntry

   De otro modo podría cascar, esto puede cambiar en el futuro. Incluya
   también 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.