Show macos.txt syntax highlighted
______ ___ ___
/\ _ \ /\_ \ /\_ \
\ \ \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 this file).
If launch MPW droping this file then, this is probably done
On Worksheet window type fixmpw.sh followed by Command-Return or Enter
this set 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 AL_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 Itens Folder
See more files for this project here