GCLIB - Repackaged OpenGC 0.2
-----------------------------
OpenGC library written by Peter (http://www.consoledev.de)
crt0.s written by Costis (http://www.gbadev.com)
Repackaged by Thorsten Titze (http://www.hangar-eleven.de)

Note:
-----

This library is not my own work. It is the same library as libogc_v02.zip but
repacked with a much more convenient makefile architecture which makes 
including additional libraries to the package much easier and own build better
to manage.

The original documentation for libogc can be found in the docs/libogc-0.2
directory.

The Makefiles are the same as for my PSX2LIB releases and are based on Dan
Potters Makefiles for KallistiOS.

Preparation/Installation:
-------------------------

1) Unpack the archive into your home directory in Cygwin
2) Edit environ.sh to fit your needs:
     You have to change GCLIB_BASE to your base-directory of GCLIB.

    If you haven't compiled the toolchains following my tutorials on
    http://www.hangar-eleven.de then you also have to change the GCLIB_CC_BASE
    to the directory where your devkit/compilers are installed.

Usage:
------

1) Before using the library you always have to load the environment by typing
   . ./environ.sh

   (Note: The "dot" in front of ./environ.sh is essential since otherwise the
    environment would not be existent after the script finishes. You may also
    put this command into your .bashrc)
2) Make the library by typing
   make

Own Projects:
-------------

Take a look into the samples/hello example which is the same example that was
included in the OGC library.
You can just copy this and change the Makefile to fit your needs.

The following make targets are available:
make all           = creates the output .elf file
make dol           = creates the output .bin file and then .dol file
make run           = makes .dol file, starts PSOload and sends the .dol file
make clean         = clean up the directory

To create something that can be uploaded to the GameCube always use the
"make dol" command which results in .bin and .dol files that can be readily
uploaded via PSOload or PSUL !

Closing Words:
--------------

If you have comments or stuff that should be included in this library please
feel free to contact me at <thorsten.titze@hangar-eleven.de>.

I hope Peter does not have any objections against me publishing this modified
package.


January 10th, 2004             Thorsten Titze (thorsten.titze@hangar-eleven.de)
