.\"Generated by db2man.xsl. Don't modify this, modify the source. .de Sh \" Subsection .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH "pilot-install-exp" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK" .SH NAME pilot-install-expenses \- Install an expense record entries onto your Palm handheld device. .SH "SECTION" .PP pilot\-link: Userland conduits .SH "SYNOPSIS" .PP \fIpilot\-install\-expenses\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-\-version\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-?\fR|\fB\-\-help\fR] [\fB\-\-usage\fR] [\fB\-t\fR|\fB\-\-ptype\fR \fBSTRING\fR] [\fB\-e\fR|\fB\-\-etype\fR \fBSTRING\fR] [\fB\-a\fR|\fB\-\-amount\fR \fBSTRING\fR] [\fB\-V\fR|\fB\-\-vendor\fR \fBSTRING\fR] [\fB\-i\fR|\fB\-\-city\fR \fBSTRING\fR] [\fB\-g\fR|\fB\-\-guests\fR \fBNUMBER\fR] [\fB\-n\fR|\fB\-\-note\fR \fBSTRING\fR] [\fB\-c\fR|\fB\-\-category\fR \fBSTRING\fR] [\fB\-\-replace\fR] .SH "DESCRIPTION" .PP \fIpilot\-install\-expenses\fR 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 \fIpilot\-install\-expenses\fR and create new expense records on your Palm handheld\&. .SH "OPTIONS" .SS "pilot-install-expenses options" \fB\-t\fR, \fB\-\-ptype\fR \fBSTRING\fR .PP 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\&. .PP Note that the long name for this option has been renamed since 0\&.11\&.8\&. \fB\-e\fR, \fB\-\-etype\fR \fBSTRING\fR .PP 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\&. \fB\-a\fR, \fB\-\-amount\fR \fBSTRING\fR .PP 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\&. \fB\-V\fR, \fB\-\-vendor\fR \fBSTRING\fR .PP Add entries to the "Vendor" field\&. These are free\-form values, and can be the name of a restaurant, an airline, or any other text value you wish to use\&. \fB\-g\fR, \fB\-\-guests\fR \fBDIGIT\fR .PP Add the number of attendees to the expense record, identified by \fBDIGIT\fR\&. If you ate lunch with four (4) additional people, you would put five (5) here, a numeric value\&. \fB\-i\fR, \fB\-\-city\fR \fBSTRING\fR .PP 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\&. \fB\-n\fR, \fB\-\-note\fR \fBSTRING\fR .PP Add a "Note" entry to the expense record\&. These are free\-form values, and can be some notes related to the expense entry\&. \fB\-c\fR, \fB\-\-category\fR \fBSTRING\fR .PP Install entries into the named category defined here\&. See the Expense application on your Palm device for full details on using these categories\&. \fB\-\-replace\fR .PP Replace the entry found in the named category identified by the \fB\-\-category\fR option .PP Note that the short name for this option has been removed since 0\&.11\&.8 .SS "Conduit Options" \fB\-p\fR, \fB\-\-port\fR <\fBport\fR> .PP Use device file <\fIport\fR> to communicate with the Palm handheld\&. If this is not specified, \fIpilot\-install\-expenses\fR will look for the \fI $PILOTPORT \fR environment variable\&. If neither are found or supplied, \fIpilot\-install\-expenses\fR will print the usage information\&. \fB\-q\fR, \fB\-\-quiet\fR .PP Suppress 'Hit HotSync button' message\&. \fB\-\-version\fR .PP Display version information for \fIpilot\-install\-expenses\fR and exit without connecting\&. .SS "Help options" \fB\-h\fR, \fB\-\-help\fR .PP Display the help synopsis for \fIpilot\-install\-expenses\fR and exit without connecting\&. \fB\-\-usage\fR .PP Display a brief usage message and exit without connecting\&. .SH "USAGE" .PP The program will connect to the Palm handheld, and install entries into the Expense application based on values passed to \fIpilot\-install\-expenses\fR arguments\&. .SH "EXAMPLE" .PP \fIpilot\-install\-expenses\fR \fI\-p\fR \fI/dev/pilot\fR \fI\-c\fR Unfiled \fI\-t\fR Cash \fI\-e\fR Meals \fI\-a\fR 10\&.00 \fI\-V\fR McDonalds \fI\-g\fR 21 \fI\-l\fR "San Francisco" \fI\-N\fR "This is a note" .PP 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\&. .SH "AUTHOR" .PP \fIpilot\-install\-expenses\fR was originally written by community authors, the original author is unknown\&. .PP This manual page was converted to XML by Neil Williams .SH "REPORTING BUGS" .PP We have an online bug tracker\&. Using this is the only way to ensure that your bugs are recorded and that we can track them until they are resolved or closed\&. Reporting bugs via email, while easy, is not very useful in terms of accountability\&. Please point your browser to http://bugs\&.pilot\-link\&.org: \fIhttp://bugs.pilot-link.org\fR and report your bugs and issues there\&. .SH "COPYRIGHT" .PP 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\&. .PP 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\&. .PP 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 St, Fifth Floor, Boston, MA 02110\-1301, USA\&. .SH "SEE ALSO" .PP \fIread\-expenses\fR (1), \fIpilot\-link\fR(7)\&.