SECTION

pilot-link: Userland conduits

SYNOPSIS

 pilot-install-memo [-p|--port <port>] [--version] [-q|--quiet] [-?|--help] [--usage] [-c|--category  name] [-r|--replace] [-t|--title] [-f|--file  STRING ...]

DESCRIPTION

 pilot-install-memo allows the user to write one or more files as a new memo or memos, respectively, onto the Palm handheld.

OPTIONS

pilot-install-memo options

                        -c,
                        --category category
                    

Install memo(s) to category defined by category. pilot-install-memo uses the Unfiled category as the default category if no category is chosen or if the specified category does not already exist on the Palm.

                        -f,
                        --file STRING
                    

File containing the target memo entry. Append other filenames to install one memo per file.

                        -r, --replace
                    

Replace all memos in the category specified by the -c category option.

                        -t --title
                    

Use the filename as the title for the memo. (Normally, the first line of a memo is used as the title if one is not supplied with the -t option).

Conduit Options

                        -p, --portport
                    

Use device file <port> to communicate with the Palm handheld. If this is not specified, pilot-install-memo will look for the $PILOTPORT environment variable. If neither are found or supplied, pilot-install-memo will print the usage information.

                        -q, 
                        --quiet
                    

Suppress 'Hit HotSync button' message

                        -v, --version
                    

Display version of pilot-install-memo and exit without connecting.

Help Options

                        -h, --help
                    

Display the help synopsis for pilot-install-memo and exit without connecting.

                        --usage 
                    

Display a brief usage message and exit without connecting.

USAGE

The program will connect to the Palm handheld, and create memo entries for each file(s) given on the commandline into the Memo Pad application on the Palm.

AUTHOR

 pilot-install-memo was originally written by Damien P. Neil <[email protected]>.

This manual page was converted to XML by Neil Williams <[email protected]>

Known Bugs

The Palm Device has a maximum length of 4,096 bytes (4k) on memopad entries, if you wish to retain the ability to edit the Memo (add/remove/change data within the memo) on the Palm itself. You can create a memo entry of 65,490 bytes in size (the absolute maximum) if you do not need to edit the memo entry any further on the Palm device itself. Any memo larger than 4,096 bytes and less than 65,490 bytes will not be editable on the Palm itself. Consider these memo entries "read-only".

This is not specifically a "bug", but a limitation in the PalmOS design itself.

Reporting Bugs

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: http://bugs.pilot-link.org and report your bugs and issues there.

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 St, Fifth Floor, Boston, MA 02110-1301, USA.