GPE-EXPENSES(1) 						   GPE-EXPENSES 						   GPE-EXPENSES(1)

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

GPE-EXPENSES 1						   Mon Dec 24 12:08:31 GMT 2007 					   GPE-EXPENSES(1)