


txt2pdbdoc(1)		  User Commands		    txt2pdbdoc(1)



NAME
     txt2pdbdoc	- Text to Doc file converter for 3Com PalmPilots

SYNOPSIS
     txt2pdbdoc	[ -b ] [ -c  ]	[  -v  ]  document-name	 file.txt
     file.pdb
     txt2pdbdoc	-d [ -v	] file.pdb [ file.txt ]
     txt2pdbdoc	-V

DESCRIPTION
     txt2pdbdoc	converts a plain text file to a	 Doc(4)	 file  in
     PDB(4)  (Pilot  Database)	format	used by	all models of the
     3Com PalmPilot and	the IBM	Workpad.  (It can also convert	a
     Doc  file	to plain text.)	 Resulting PDB files can be down-
     loaded 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.

     -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 out-
	  put and exit.

EXAMPLE
     To	convert	a text file to Doc file:

	  txt2pdbdoc 'Through the Looking Glass' alice.txt alice.pdb


EXIT STATUS
     Exits with	a value	of  zero  only	if  conversion	completed
     sucessfully; non-zero otherwise.

CAVEATS
     1.	 Document names	are limited to 31 characters in	PDB  for-
	 mat.	Longer	names  are truncated but have the 29-31st



txt2pdbdoc	  Last change: August 18, 1998			1






txt2pdbdoc(1)		  User Commands		    txt2pdbdoc(1)



	 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
     doc(4), pdb(4)

AUTHOR
     Paul J. Lucas <pjl@best.com>












































txt2pdbdoc	  Last change: August 18, 1998			2



