NAME
gpe-expenses - Expense records for GPE using QOF (Query Object
Framework).
EMBEDDED PLATFORMS
Embedded platforms can choose not to include the libxml2 backend which
means that QOF cannot provide the QOF XML backend (called QSF XML).
Other platforms are free to use any available QOF backend. All
platforms support the SQLite backend, command-line and --gui operation.
SQLite databases written on embedded platforms without libxml2 can be
copied to the host PC for further processing and conversion of data to
or from QSF XML and other formats. SQLite databases can also be queried
directly, either using the sqlite application or at the gpe-expenses
command line. Without libxml2 support, the output needs to be written
to a new SQLite database but this can be used, e.g. to export certain
categories of expenses, expenses within a particular time period or
expenses that match other similar criteria to a new SQLite database.
When accessing a SQLite database on the gpe-expenses command line, you
need to specify the sqlite: access method (in a similar manner to
specifying a particular protocol in the URL of other applications).
See Examples.
SYNOPSIS
gpe-expenses {[[--gui]]} [[[--debug]]]
gpe-expenses {[[--explain]]}
gpe-expenses {[[-l] | [--list]]}
gpe-expenses {[[--version]]}
gpe-expenses {[[-?] | [--help]]}
gpe-expenses [[[--usage]]]
gpe-expenses {[[-i] | [--input-file]] filename}
[[[-c] | [--category]] string] [[[-t] | [--date]] string]
[[[-s] | [--sql]] string] [[[-f] | [--sql-file]] filename]
[[[-w] | [--write]] filename] [[[--debug]]]
DESCRIPTION
GPE Equivalent for Expenses on the Palm. Supports payment types,
categories, expense types (mileage, meals, parking, etc.), notes and
currency selection via a Gtk interface. Where available, SQLite data
can be easily converted to XML using a QOF format called ´QSF´,
suitable for use with XSL and other tools.
COMMANDS
--gui
Load the Gtk graphic interface. Options -w, -s, -f, -t and -c are
ignored.
-i, --input-file filename
Load the QSF XML file:filename or SQLite database sqlite:filename.
file: access requires libxml2 support and the QSF XML backend. To
access data in a gpe-expenses SQLite database, specify the sqlite:
access method. See under EXAMPLES.
-l, --list
Lists all available databases and exit.
--explain
List the fields within the gpe_expenses database and exit. Only the
one database is currently supported in gpe-expenses.
OPTIONS
gpe-expenses options
-c, --category string
Shorthand to only query objects that are set to the specified
category.
(Ignored by --gui).
-t, --date string
Shorthand to only query objects that contain the specified date.
Specify dates using YY-MM-DD, YY-MM or just YY. Single digits can
omit the leading zero, e.g. 04-12-1, 1st December 2004 - years less
than 100 are assumed to be in the 21st century. Years prior to 2000
can be specified as YYYY-MM-DD etc. This value is taken as a range,
05-03-01 includes all times between Tue Mar 1 00:00:00 UTC 2005 and
Tue Mar 1 23:59:59 UTC 2005. 05-03 includes all dates and times
between Tue Mar 1 00:00:00 UTC 2005 and Thu Mar 31 23:59:59 UTC
2005. 05 includes all dates and times in 2005.
(Ignored by --gui).
-w, --write filename
Write the results of any query to a SQLite database or (if libxml2
is supported) a QSF XML file.
Remember to specify the sqlite: access method if libxml2 is not
supported.
(Ignored by --gui).
-s, --sql string
Specify a SQL query on the command line.
(Ignored by --gui).
-f, --sql-file filename
Specify one or more SQL queries contained in a file.
(Ignored by --gui).
--debug
Enable debug output using /tmp/gpe-expenses.trace which will be
created if it does not exist and overwritten if it does. If this
fails, tries to create a temporary trace file in /tmp or uses
stderr.
help options
-h, --help
Display the help synopsis for gpe-expenses.
--usage
Display a brief usage message and exit without connecting.
-v, --version
Display version of gpe-expenses.
EXAMPLES
Start the GPE-EXPENSES graphic interface with debug output sent to
/tmp/gpe-expenses.trace
gpe-expenses --gui --debug
List all currently supported databases.
gpe-expenses -l
Copy all expenses in 2005 to a backup SQLite database.
gpe-expenses -i sqlite:/home/user/.gpe-expenses/expenses -w
sqlite:business.sqlite -t 2005
Export all expenses that have the category Business using libxml2 and
the QSF XML backend to STDOUT. Note that file: is the default access
method and can be omitted only if libxml2 support is available. (SQLite
is unable to output to STDOUT, always use -w with SQLite.)
gpe-expenses -i expenses.xml -c "Business"
Command line SQL query of SQLite storage.
gpe-expenses -i sqlite:business.sqlite -s "SELECT * from gpe_expenses
where expense_city = ´London´;"
AUTHOR
gpe-expenses was written by Neil Williams linux@codehelp.co.uk.
This manual page was written by Neil Williams linux@codehelp.co.uk
REPORTING BUGS
Please do NOT report bugs in gpe-expenses to GPE. Report bugs via the
QOF-devel mailing list or use the reportbug tool in Debian.
http://lists.sourceforge.net/lists/listinfo/qof-devel
COPYRIGHT
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.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
SEE ALSO
http://gpe-expenses.sourceforge.net/
http://sourceforge.net/projects/gpe-expenses/
COPYRIGHT