txt2pdbdoc(1)
NAME
txt2pdbdoc - Text to Doc file converter for Palm Pilots
SYNOPSIS
txt2pdbdoc [-b] [-c] [-v] document-name file.txt file.pdb txt2pdbdoc -d [-D] [-v] file.pdb [ file.txt ] txt2pdbdoc -V
DESCRIPTION
txt2pdbdoc converts a plain text file to a Doc(4) file in PDB (Pilot
Database) format used by all models of the Palm Pilot. (It can also
convert a Doc file to plain text.) Resultant PDB files can be downloaded directly to a Pilot during a HotSync.
The document-name is used in the Document List view of a Doc reader
application on the Pilot.
OPTIONS
- -b Ordinarily, characters with an ASCII code less than 9 are removed
- and both carriage-returns and form-feeds are converted to newlines. This option suppresses that behavior.
- -c Ordinarily, text is compressed. This option suppresses compres
- sion.
- -d Decode the given Doc file to text either to a file or to standard
- output if no file is specified.
- -D Do not check the file type/creator of the file to decode. This
- option should be specified only if you know for sure that the file is in fact some sort of Doc file. Attempting to decode non-Doc files will result in undefined behavior and quite possibly crash.
- -v Verbose mode. For encoding, print progress and compression sta
- tistics per 4K of text to standard error as well as overall statistics when completed; for decoding, print progress in a ``countdown'' style.
- -V Print the version number of txt2pdbdoc to standard output and
- exit.
EXAMPLE
- To convert a text file to Doc file:
- txt2pdbdoc 'Through the Looking Glass' alice.txt alice.pdb
EXIT STATUS
- Exits with one of the values given below:
- 0 Success.
1 Error in command-line options or use.
2 Unable to open source file.
3 Unable to open destination file.
4 Unable to read file.
5 Unable to write file.
6 File is not a Doc file.
7 Doc file uses unknown compression type.
CAVEATS
- 1. Document names are limited to 31 characters in PDB format. Longer
- names are truncated but have the 29-31st characters replaced by ``...'' to indicate truncation.
- 2. The command isn't called ``txt2doc'' to avoid confusion about pos sibly having anything to do with Microsoft Word documents that use the .doc extension.
SEE ALSO
html2pdbtxt(1), pdbtxt2html(1), doc(4), pdb(4)
AUTHOR
- Paul J. Lucas <pauljlucas@mac.com>