Building and installing Cumulus

These are instructions to build and install Cumulus from source under Linux.

Step 1)
You will need to set up a building-environment for QtE applications. Follow
the instructions on

http://docs.zaurus.com/index.php?id=linux_compiler_setup_howto

to download and install the necessary tools. If you want to be able to build
ipk packages, you also need to install the ipkg tools and make sure they are
in your path. This is needed for step 5a).

Step 2)
Select the environment you want to compile for (ARM or X86), and run the
appropriate batchfile like described on the page referenced above.
Don't forget to run "make clean" before re-compiling for a different
architecture!

Step 3)
Make a symlink from the Cumulus subdirectory to:
/opt/Embedix/tools/arm-linux/include/asm/sharp_char.h

Step 4)
In the Cumulus directory, run "make" to start compilation.

Step 5a)
If you selected ARM in step 2, you can run "make release" to build all the
ipk packages, including the languagepacks. The packages will be build in
the ipkg subdirectory.

Step 5b)
If you selected X86 in step 2, you can run "qvfb &", "qpe &" and
"cumulus/cumulus &" to start Cumulus in a virtual framebuffer under X.


To see what targets the makefile supports, just look at it using less. It's
all pretty obvious ;-)
