           install-expenses  - Install an expense record from various
           parameters and arguments passed at connection time.

## SECTION

           pilot-link: Userland Conduits

## SYNOPSIS

           install-expenses    [-p|--port     <port>]     [--version]
           [-q|--quiet]  [-?|--help]  [--usage]  [-t|--ptype  STRING]
           [-e|--etype  STRING]  [-a|--amount  STRING]   [-V|--vendor
           STRING] [-i|--city STRING] [-g|--guests NUMBER] [-n|--note
           STRING] [-c|--category STRING] [--replace]

## DESCRIPTION

           install-expenses allows a Palm handheld with  the  Expense
           application  to  have  expense  records synchronized to it
           from the commandline. You  can  pass  any  of  the  fields
           (except  categories,  currently)  to  install-expenses and
           create new expense records on your Palm handheld.

## OPTIONS

       INSTALL-EXPENSES OPTIONS
           -t, --ptype STRING
                  Add entries to the "Payment Type" field. These  can
                  be  in the form of "Cash", "Cheque" and others. See
                  the Expense application on  your  Palm  device  for
                  full details on payment types.

                  Note  that  the  long name for this option has been
                  renamed since 0.11.8.

           -e, --etype STRING
                  Add entries to the "Expense Type" field. These  can
                  be  in  the form of Airfare, Meals, and Others. See
                  the Expense application on  your  Palm  device  for
                  full details on expense types.

           -a, --amount STRING
                  Add  currency amount entries to the "Amount" field.
                  These can be in the form of 1.00 or "$10.00" and so
                  on. See the Expense application on your Palm device
                  for full details on amount types.

           -V, --vendor STRING
                  Add  entries  to  the  "Vendor"  field.  These  are
                  free-form  values, and can be the name of a restau-
                  rant, an airline, or any other text value you  wish
                  to use.

           -g, --guests DIGIT
                  Add  the number of attendees to the expense record,
                  identified by DIGIT. If you ate lunch with four (4)

           -i, --city STRING
                  Add entries to the  "City"  field  in  the  expense
                  record.  These are free-form values, and can be the
                  name of  the  location,  city,  or  town  that  the
                  expense record occured in.

           -n, --note STRING
                  Add a "Note" entry to the expense record. These are
                  free-form values, and can be some notes related  to
                  the expense entry.

           -c, --category STRING
                  Install  entries  into  the  named category defined
                  here. See the  Expense  application  on  your  Palm
                  device  for full details on using these categories.

           --replace
                  Replace the entry found in the named category iden-
                  tified by the --category option

                  Note  that  the short name for this option has been
                  removed since 0.11.8

       CONDUIT OPTIONS
           -p, --port <port>
                  Use device file <port> to communicate with the Palm
                  handheld.     If    this    is    not    specified,
                  install-expenses will look for the $PILOTPORT envi-
                  ronment variable. If neither are found or supplied,
                  install-expenses will print the usage  information.

           -q, --quiet
                  Suppress 'Hit HotSync button' message

           --version
                  Display  version  information  for install-expenses
                  and exit without connecting.

       HELP OPTIONS
           -h, --help
                  Display the help synopsis for install-expenses  and
                  exit without connecting.

           --usage
                  Display a brief usage message and exit without con-
                  necting.

## USAGE

           The program will connect to the Palm handheld, and install
           entries  into  the  Expense  application  based  on values
           passed to install-expenses arguments.
           install-expenses -p /dev/pilot -c Unfiled -t Cash -e Meals
           -a 10.00 -V McDonalds -g 21 -l "San Francisco" -N "This is
           a note"

           Installs a new expense; you are recording having 21 guests
           at McDonalds in the city of San Francisco for a meal which
           cost 10.00 units of your default currency and you added  a
           simple  note.  The  expense  will  take the default date -
           today.

## AUTHOR

           install-expenses was written  by  community  authors,  the
           original author is unknown.

           This  manual page was written by Neil Williams linux@code-
           help.co.uk

## REPORTING BUGS

           Report bugs at: http://bugs.pilot-link.org

## 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., 59  Temple  Place,  Suite  330,
           Boston, MA 02111-1307 USA

## SEE ALSO

           read-expenses (1), pilot-link(7).