PyMoney is a personal financial assistant.

Copyright (C) 2005 Dmitri Brechalov

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA


REQUIREMENTS
------------

The program is written in Python and works where Python and Qt work.
It is developed mainly for Sharp Zaurus SL-Cxxx devices but can be
used on desktop with Linux, FreeBSD or even M$ Wind*ws (tested on
RedHat 9 and Debian Linux).

* Python >= 2.3 (2.2 also works but 2.3 is better)
* Qt 3
* PyQt


INSTALLATION
------------

From version 0.10 the program is ditributed in tar.gz files for
desktop and ipk files for Zaurus.

Important notes
---------------

If you upgrade PyMoney from the version less than 0.5, please do the
following steps immediately after unpacking new version and before
starting the program:

    $ cd ~/PyMoney # or where the program has been installed
    $ ./fixaccounts.py

This is necessary due to database format changed.

If you use PyMoney on desktop and upgrade it from version less than
0.10, probably you have to change database format from dbm to cdbm
(actually crypted dumbdbm) because since version 0.10 PyMoney works
with cdbm only! To upgrade your database install new version first,
then do the following steps before starting the program:

    $ cd /opt/QtPalmtop/share/PyMoney # or where the program installed
    $ ./fixdatabase.py

Then you can remove all files except *.dir and *.dat from ~/pymoney.db

Installation on Zaurus
----------------------

Just install ipk-file as usual (using Add/Remove Software GUI
application or ipkg console tool).

Do not forget to remove any previous installation of the program
(but not the database!)

Installation on desktop
-----------------------

Unpack tar.gz file to any directory you want.


DATABASE
--------

PyMoney uses cdbm which is dumbdbm with simple cryptographic
support. There are two files for each table: .dir file contains
index for the table and .dat file contains records as pickled python
objects (usually lists and dictionaries).

By default the database is located in ~/pymoney.db directory. You
can indicate database location by creating pymoney.rc file which
should contain only one line -- path to the database.


PASSWORD PROTECTION
-------------------

You can protect your personal data with password (menu tools/set
password). When password is set all data of accounts will be
crypted.
