Oz-compat HowTo

Why do I need it?
If you are running a gcc3 ROM like the current OpenZaurus 3.3.6-pre1 gcc3 ROM (there's a gcc2 version, too) you are pretty much incompatible with the rest of the world. GCC3 changed a lot of internal library functions and as a result, older gcc2 software won't run on a gcc3 system. The oz-compat package contains libraries compiled against gcc2 and modifies the system environment for selected (gcc2) programs so they can be used with an gcc3 installation.

So why use gcc3 at all?
Because it produces highly optimized code. Or in other words: gcc3 programs start much faster than gcc2 applications.

Installation
Note: You need to have a CF or SD-Card, or some space in the ramdisk to install oz-compat as it doesn't fit into the ROM.

ipkg -d $target ./oz-compat*.ipk ipkg-link add oz-compat
 * Download the official oz-compat-x.x.ipk package from here.
 * Install it onto your CF (/mnt/cf), SD-Card (/mnt/card) or ramdisk (/mnt/ram) either using the PackageManager or AQPkg application, or on the console with the commands

Replace $target with sd for SD-Cards, cf for CF-Cards or ram for the ramdisk.

Configuration

 * Switch to the Settings tab and start the Libraries application.
 * Click the List button and change to the category / tab where your gcc2 program is located.
 * Select the gcc2 application and click Ok two times.
 * Repeat the above steps to configure more apps to use oz-compat.

[FIXME: insert some screenshots of the configuration dialog]

Usage
Applications configured to use oz-compat can be launched via their icon just like normal applications. You shouldn't see a difference to gcc3 apps.

[FIXME: insert screenshot of a hancom / tkc application runnig under 3.3.6-pre1]

The magic behind oz-compat
To be written...