txt2pdbdoc(1)                        General Commands Manual                        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 compression.

       -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 statistics 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 possibly 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>

txt2pdbdoc                               January 21, 2005                           txt2pdbdoc(1)