\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ddbugtopbm User Manual" 1 "21 August 2002" "netpbm documentation"

.SH NAME
ddbugtopbm - convert Diddle or DiddleBug sketches to PBM files

.UN synopsis
.SH SYNOPSIS

\fBddbugtopbm\fP

.UN examples
.SH EXAMPLES

.nf
\fBddbugtopbm </path/to/palm/backup/dir/DiddleBugDB.pdb\fP

\fBddbugtopbm </path/to/palm/backup/dir/DiddleDB.pdb\fP

\fBddbugtopbm </path/to/palm/backup/dir/DiddleIDB.pdb\fP

.fi


.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBddbugtopbm\fP converts all sketches present in a database used
by the PalmOS programs \fBDiddle\fP or \fBDiddleBug\fP into
appropriately-named PBM files.  The backup copy of DiddleBug's
database you should use as this program's input is usually called
\fBDiddleBugDB.pdb\fP.  Or if you use the original Diddle, it has two
separate DBs - \fBDiddleDB.pdb\fP, containing unnamed `scratch'
sketches, and \fBDiddleIDB.pdb\fP, containing the saved (and named)
sketches which are listed by its `index' option.  You can feed this
program any of these three on standard input.

.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBddbugtopbm\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN using
.SH USING THE PROGRAM
.PP
I recommend you \fInot\fP run \fBddbugtopbm\fP from your Palm
backup directory, i.e. don't run it from the directory the DB will
normally be in.  Instead, run it from some other directory (perhaps you
could make a directory purely to hold the PBM files, just to keep
things simple) and use an absolute or relative path to the DB.
.PP
The filenames used for the output PBMs are based on the names given
to each sketch; if you have an unnamed sketch, it's given a name along
the lines of \fBsketch-0123.pbm\fP.
.PP
While the named sketches will overwrite any existing PBM file with
the same name, the unnamed ones won't - they'll just try using another
filename.  (I think this is probably the right approach, as you can't
really tell the unnamed sketches apart.)



.UN limitations
.SH LIMITATIONS
.PP
The DiddleBug DB reader is only known to work with DBs from
DiddleBug version 2.50. But it should probably work on later versions,
and I think it'll work on DBs from version 2.15 as well.
.PP
It might fall over if fed an empty database, and doesn't do much
(if any) checking of the input.


.UN author
.SH AUTHOR

Russell Marks (\fIrus@svgalib.org\fP).
.PP
Mitch Blevins's decompression code is directly from DiddleBug
itself, which like ddbugtopbm is distributed under the terms of the
GNU GPL.

.UN seealso
.SH SEE ALSO
.PP
.BR "palmtopnm" (1)\c
\&,
.BR "pbm" (1)\c
\&
.PP
Jens-Chr. Heyer's `didcon' script does something similar.

.UN history
.SH HISTORY
.PP
\fBddbugtopbm\fP was new in Netpbm 10.18 (August 2003).  It was written
and independently distributed in August 2002.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/ddbugtopbm.html
.PP