1 files changed, 117 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/ddbugtopbm.1 b/upstream/mageia-cauldron/man1/ddbugtopbm.1
new file mode 100644
index 00000000..5bf76bb7
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/ddbugtopbm.1
@@ -0,0 +1,117 @@
+\
+.\" 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" 0 "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
+\ No newline at end of file