Table of Contents
This chapter contains miscellaneous informations for FreeCoins developers.
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 PDF
version 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.