Man Linux: Main Page and Category List

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