          ______   ___    ___
         /\  _  \ /\_ \  /\_ \
         \ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___ 
          \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\
           \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \
            \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
             \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
                                            /\____/
                                            \_/__/
 
       MPW ReadMe file
 
       By Ronaldo H. Yamada
  
       See readme.txt for copyright information.

       
 
====================================
============ MPW notes =============
====================================

   This port is not garanted to work on every machines.
   I'll like know about how this port is working.

   Status: the minimum to work, this version is much newer than the Others,
   so can be the most buggy. Consult the file todo.txt for a list of what's
   missing or otherwise not working very well.



===========================================
============ Required hardware ============
===========================================

   - An Power Macintosh



===========================================
============ Required software ============
===========================================

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

   I created Allegro port on theses versions, 
   I not determine if it can work on others, you must try, and I'll like
   know about this.

   The MPW-GM can be obtained directly from Apple. <ftp://ftp.apple.com/
   developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM_Images/>
   An old version of the headers is included with MPW, but I use a new set
   <ftp://ftp.apple.com/developer/Development_Kits/UniversalHeaders3.3.1.img.bin>
   DrawSprocketSDK and SoundManager can be obtained directly from Apple.

   * the final users can need theses softwares.



============================================
============ Installing Allegro ============
============================================

   This is a source-only distribution, so you will have to compile Allegro 
   before you can use it. To do this you should:

   Set up the current directory to main allegro dir (which contains the file
   fixmpw.sh). If launch MPW droping this file then, this is probably done.

   On Worksheet window type fixmpw.sh followed by Command-Return or Enter.
   This sets the library up ready for use.
   
   Install a debugging version of the library, be patient this take many
   minutes. If required you must quit the MPW Shell before use the library.



================================================
============ Custom install Allegro ============
================================================

	Option      Action
	all         build and install all
	alld        build and install library only
	tests       build and install tests and library
	examples    build and install examples and library
	docs        build and install documentation in html format

	example:

   	fixmpw.sh alld tests <enter>

      

=======================================
============ Using Allegro ============
=======================================

   Allegro could be work like an Shared Library, so for future compatibility
   you must define the preprocessor should symbol ALLEGRO_STATICLINK before 
   including any of the Allegro headers.

   Don't forget that you need to use the END_OF_MAIN() macro right after 
   your main() function. for future and plataform compatibility

   All the Allegro functions, variables, and data structures are defined in 
   allegro.h.You should include this in your programs

   <Allegro.h>

   But allegro.h not cause poluition on main include folder, it reside in
   Allegro folder installed into Interfaces&Libraries folder the you must
   set up as include folder in compiling
   
   -i {Allegro} (or Includes = -i {Allegro} on automatic created makefiles)

   do ensure link with the libraries:

	"{Allegro}allegro.x"          -  allegro static library
	"{SharedLibraries}InterfaceLib"
	"{SharedLibraries}StdCLib"
	"{SharedLibraries}MathLib"
	"{SharedLibraries}DrawSprocketLib"
	"{PPCLibraries}StdCRuntime.o"
	"{PPCLibraries}PPCCRuntime.o"
	"{PPCLibraries}PPCToolLibs.o"

   you always should tell about allegro entry point in linking, include this
   option:
   
   -m MacEntry

   otherwise you will crash, this can change in future

   also should include the Resource file

   "{Allegro}allegro.r"      - some resources need to allegro work

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

   see examples in tests:mac folder



==========================================
============ Unistall Allegro ============
==========================================

   Delete the Allegro Folder at Interfaces&Libraries
   and the Script "SetAllegro" from Startup Items Folder.
   
