Initial revision

1 files changed, 94 insertions, 0 deletions

diff --git a/noncore/apps/qashmoney/README b/noncore/apps/qashmoney/README
new file mode 100755
index 0000000..1888ce6
--- a/dev/null
+++ b/noncore/apps/qashmoney/README
@@ -0,0 +1,94 @@
+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.