Chapter 4. Developer information

Table of Contents

Compiling FreeCoins (and other PalmOS programs)
Translating FreeCoins
Translating the help for FreeCoins
CVS information

This chapter contains miscellaneous informations for FreeCoins developers.

Compiling FreeCoins (and other PalmOS programs)

In the following paragraphs I shall detail my own setup. You should be able to follow this to obtain the same result with your own distro (I am assuming you are running Linux; if you aren't then you are on your own). I am using a standard RedHat 7.3 install, to which I added the following programs:

  • First of all, install prc-tools-2.2. This is a port of gcc able to produce PalmOS executables. You can obtain this program from SourceForge. I used the packaged (RPM) version. Note that linking will fail with previous versions of prc-tools.

  • You need palmos-sdk-4.0 in order to compile any PalmOS programs. I use the packaged version (RPM) which installs to the /opt/palmdev/sdk-4 directory, where it creates an include and a lib subdirectory containing the .h files and respectively the libraries. The unpackaged version is also available but you need to create these directories and place the files manually. Read the README for palmos-sdk for more detailed installation information. This file can be obtained from the PalmOS website (check out the developer section)

  • Install palmos-sdk-4.0-update1. This involves copying a bunch of .h files over the ones installed during the previous step. The update can be obtained from the PalmOS website

  • Create a /opt/palmdev/sdk symlink pointing to /opt/palmdev/sdk-4. Now run palmdev-prep as user root. This program is part of the prc-tools package. This will autodetect your PalmOS SDK and setup the prc-tools package to use it.

  • Finally, you need to install pilrc-2.9. This program is needed to compile program resources (such as forms, menus, dialogs, etc.). Check out SourceForge to find the homepage for this program. I compile it from source and then install it normally (configure; make install)

  • The Palm emulator: pose-3.5. I compile it from source. Make sure that you install the fltk library, as it is needed by pose. I am using fltk-1.0.11. You need the emulator to test FreeCoins, without the hassle of having to use a real device. You also need a ROM image for the device. You can download one from your own device, or obtain images for various OSs from the PalmOS website.

  • You will also need the xmlto package, together with jade or some other XML processor in order to process the documentation. TeX is needed to generate the PDFversion of the documentation. The manual uses the XML DocBook 4.1.2 DTD, so make sure you have that available. All these packages should be readily available for most distros (I use RedHat 7.3 and a standard install is enough to supply all the packages needed)

Once you have the programs above installed and working unpack get the FreeCoins source code (you can obtain it from CVS -- see the website for information on how to do so) and run the following commands in the freecoins directory: ./bootstrap; ./configure --host=m68k-palmos; make. This should produce a bunch of files named FreeCoins-LL.prc, where LL is a language code (such as en, fr, etc.). You can install these files on the emulator or on a real device.

It is important that you specify the --host=m68k-palmos parameter to configure. If you do not do this, configure will not be aware that you are trying to cross-compile.

Use the apidoc target of the top-level Makefile to generate source code documentation.