Diffstat (limited to 'noncore/apps/qashmoney/README') (more/less context) (ignore whitespace changes)
-rwxr-xr-x | noncore/apps/qashmoney/README | 94 |
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 @@ | |||
1 | QashMoney - Budget Software for the Sharp Zaurus | ||
2 | |||
3 | README | ||
4 | |||
5 | Welcome to the latest version of QashMoney! This app is designed to make your | ||
6 | budgeting fast, inuitive and easy. | ||
7 | |||
8 | This file lists all the important files in the qashmoney CVS directory and how | ||
9 | to make the IPK file that goes on the Zaurus. When you checkout the | ||
10 | qashmoney module from CVS, it will create a directory on your hard drive called | ||
11 | qashmoney. These instructions assume you are in the directory. | ||
12 | |||
13 | The first thing you need to do is have all the necessary cross-compile software | ||
14 | and Qtopia installed on your system. I assume you have already done this since | ||
15 | you are downloading CVS, but if not, go to: | ||
16 | |||
17 | http://docs.zaurus.com | ||
18 | |||
19 | and download the RPMS that you need for development. | ||
20 | |||
21 | You also must have sqlite installed on your system to successfully compile | ||
22 | QashMoney. Go to: | ||
23 | |||
24 | http://www.sqlite.org | ||
25 | |||
26 | to download this progam. The SQLite library has already been compiled for the | ||
27 | IPK and is in the 'install' directory. So there is no need to compile SQLite | ||
28 | for ARM but you can if you want. There are instructions for that on the | ||
29 | website. | ||
30 | |||
31 | After that, set the correct environment variables for the package you | ||
32 | are developing.Two scripts in the qashmoney are used for that purpose: x86.sh | ||
33 | andarm.shIf you are buidling for x86 type: | ||
34 | |||
35 | source x86.sh | ||
36 | |||
37 | and press enter. To make binaries that run on the Zaurus, type: | ||
38 | |||
39 | source arm.sh | ||
40 | |||
41 | Next, construct the makefile by typing: | ||
42 | |||
43 | tmake -o Makefile qashmoney.pro | ||
44 | |||
45 | tmake is Trolltech's program for constructing a typical GNU Makefile from the | ||
46 | project file (qashmoney.pro for this application). If you get an "error: tmake | ||
47 | command not found", you either don't have all the correct RPMS installed or your | ||
48 | environment variables are not correctly set. If all is well type: | ||
49 | |||
50 | make | ||
51 | |||
52 | and the program should be constructed and you will be left with a qashmoney | ||
53 | binary in this directory. If you compiled for x86, you can see the application | ||
54 | by using the Qt Virtual Frame Buffer which emulates the Qtopia environment on | ||
55 | your computer. First, copy all the files from the databasefiles directory within the | ||
56 | qashmoney directory. Otherwise, the program will not function. | ||
57 | |||
58 | To run QashMoney in the Qtopia Virtual Frame Buffer, type: | ||
59 | |||
60 | qvfb & | ||
61 | ./qashmoney -qws | ||
62 | |||
63 | and QashMoney should appear in the frambuffer. You can use and test qashmoney | ||
64 | here as you would on the Zaurus. | ||
65 | |||
66 | If you compile the binary file for the Zaurus, another script in this directory | ||
67 | will come in handy. To automagically make the IPK file, type: | ||
68 | |||
69 | su | ||
70 | ./make_ipk | ||
71 | |||
72 | You need to be the root user to set the ownership of the binary and other | ||
73 | files correctly. The IPK file will appear in the qashmoney directory. Now put | ||
74 | this file onto the Zaurus and install! | ||
75 | |||
76 | Two other scripts in the directory may be of use. The make_x86 script cleans | ||
77 | the directory and makes the x86 qashmoney binary automatically. The make_arm | ||
78 | scripts makes the ARM binary. So you should really only have to type three | ||
79 | commands the make the IPK file: | ||
80 | |||
81 | ./make_arm | ||
82 | su | ||
83 | ./make_ipk | ||
84 | |||
85 | I hope the program can be useful. If you have any questions or comments, please | ||
86 | contact me at qashmoneyman@attbi.com | ||
87 | |||
88 | Thanks! | ||
89 | |||
90 | Allen | ||
91 | |||
92 | Disclaimer: Altough I've tried to make this application tight and well | ||
93 | functioning, it comes with absolutely no warranty and I will not be liable for | ||
94 | any damage it may cause. | ||