You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

174 lines
7.0 KiB

.\"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 <linux@codehelp\&.co\&.uk>
.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)\&.