QashMoney - Budget Software for the Sharp Zaurus

README

Welcome to the latest version of QashMoney!  This app is designed to make your
budgeting fast, inuitive and easy.

This file lists all the important files in the qashmoney CVS directory and how
to make the IPK file that goes on the Zaurus.  When you checkout the
qashmoney module from CVS, it will create a directory on your hard drive called
qashmoney.  These instructions assume you are in the directory.

The first thing you need to do is have all the necessary cross-compile software
and Qtopia installed on your system.  I assume you have already done this since
you are downloading CVS, but if not, go to:

http://docs.zaurus.com

and download the RPMS that you need for development.

You also must have sqlite installed on your system to successfully compile
QashMoney.  Go to:

http://www.sqlite.org

to download this progam.  The SQLite library has already been compiled for the
IPK and is in the 'install' directory.  So there is no need to compile SQLite
for ARM but you can if you want.  There are instructions for that on the
website.

After that, set the correct environment variables for the package you
are developing.Two scripts in the qashmoney are used for that purpose: x86.sh
andarm.shIf you are buidling for x86 type:

source x86.sh

and press enter.  To make binaries that run on the Zaurus, type:

source arm.sh

Next, construct the makefile by typing:

tmake -o Makefile qashmoney.pro

tmake is Trolltech's program for constructing a typical GNU Makefile from the
project file (qashmoney.pro for this application).  If you get an "error:  tmake
command not found", you either don't have all the correct RPMS installed or your
environment variables are not correctly set.  If all is well type:

make

and the program should be constructed and you will be left with a qashmoney
binary in this directory.  If you compiled for x86, you can see the application
by using the Qt Virtual Frame Buffer which emulates the Qtopia environment on
your computer.  First, copy all the files from the databasefiles directory within the
qashmoney directory.  Otherwise, the program will not function.

To run QashMoney in the Qtopia Virtual Frame Buffer, type:

qvfb &
./qashmoney -qws

and QashMoney should appear in the frambuffer.  You can use and test qashmoney
here as you would on the Zaurus.

If you compile the binary file for the Zaurus, another script in this directory
will come in handy.  To automagically make the IPK file, type:

su
./make_ipk

You need to be the root user to set the ownership of the binary and other
files correctly.  The IPK file will appear in the qashmoney directory.  Now put
this file onto the Zaurus and install!

Two other scripts in the directory may be of use.  The make_x86 script cleans
the directory and makes the x86 qashmoney binary automatically.  The make_arm
scripts makes the ARM binary.  So you should really only have to type three
commands the make the IPK file:

./make_arm
su
./make_ipk

I hope the program can be useful.  If you have any questions or comments, please
contact me at qashmoneyman@attbi.com

Thanks!

Allen

Disclaimer:  Altough I've tried to make this application tight and well
functioning, it comes with absolutely no warranty and I will not be liable for
any damage it may cause.