INSTALLING FROM deb PACKAGE
===========================

On a Linux desktop: dpkg -i shishensho_0.1.1-1_i386.deb

On Maemo: Open the deb file with the file manager or download it with a 
browser. Follow the instructions of the application manager.

CREATING A deb PACKAGE FROM C SOURCES
=====================================

Just execute:

./autogen.sh
./build-package.sh

If you want to create a Maemo (armel) package, just do the former inside 
the scratchbox using the CHINOOK_ARMEL target. To activate Maemo specific
features you'll need to rebuild the project from Vala sources (see next
section).

For more info about scratchbox and targets, have a look at:

http://maemo.org/development/documentation/tutorials/maemo_4-0_tutorial.html

COMPILING VALA SOURCES TO C SOURCES
===================================

From src directory, execute:

./compile.sh

Compilation infrastructure uses a preprocessor for conditional compilation.
You can define symbols by passing them as arguments to the previous script:

./compile.sh DEV MAEMO

These are the currently supported symbols:

DEV = Development mode. Loads images and files from the current directory
      instead of from /usr/share/shishensho
      
MAEMO = Compiles features only present in the Maemo platform (TODO)

Preprocessed source files are stored at the CPP directory. Check them if
compilation errors appear, cause the source line in the error will be the
one in the preprocessed file, not in the original file.

This compilation also generates an executable that can be launched
immediately. After having compiled to C sources, if you want to generate a
Debian package, just follow the steps of the previous section.

VALA COMPILER INSTALLATION
==========================

To install the Vala compiler on the scratchbox, follow this steps logged
into the scratchbox in the desired target (eg: CHINOOK_ARMEL):

1. Download the compiler from: http://live.gnome.org/Vala/Release
(currently supported version is 0.3.2)

2. Untar it: tar jxvf vala-0.3.2.tar.bz2

3. Enter the vala-0.3.2 directory and configure the package for ARMEL
cross compiling: ./configure --host=armel

4. Compile and install: make; make install

Alternately, to build for target CHINOOK_X86, repeat the previous steps
but logged into the CHINOOK_X86 target. In step 3, issue ./configure
without arguments instead.


