Provided by: txt2pdbdoc_1.4.4-6_i386 bug

txt2pdbdoc(1)                                                    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)