| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "Ddbugtopbm User Manual" 1 "21 August 2002" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
ddbugtopbm - convert Diddle or DiddleBug sketches to PBM files |
| 10 |
|
| 11 |
.UN synopsis |
| 12 |
.SH SYNOPSIS |
| 13 |
|
| 14 |
\fBddbugtopbm\fP |
| 15 |
|
| 16 |
.UN examples |
| 17 |
.SH EXAMPLES |
| 18 |
|
| 19 |
.nf |
| 20 |
\fBddbugtopbm </path/to/palm/backup/dir/DiddleBugDB.pdb\fP |
| 21 |
|
| 22 |
\fBddbugtopbm </path/to/palm/backup/dir/DiddleDB.pdb\fP |
| 23 |
|
| 24 |
\fBddbugtopbm </path/to/palm/backup/dir/DiddleIDB.pdb\fP |
| 25 |
|
| 26 |
.fi |
| 27 |
|
| 28 |
|
| 29 |
.UN description |
| 30 |
.SH DESCRIPTION |
| 31 |
.PP |
| 32 |
This program is part of |
| 33 |
.BR "Netpbm" (1)\c |
| 34 |
\&. |
| 35 |
.PP |
| 36 |
\fBddbugtopbm\fP converts all sketches present in a database used |
| 37 |
by the PalmOS programs \fBDiddle\fP or \fBDiddleBug\fP into |
| 38 |
appropriately-named PBM files. The backup copy of DiddleBug's |
| 39 |
database you should use as this program's input is usually called |
| 40 |
\fBDiddleBugDB.pdb\fP. Or if you use the original Diddle, it has two |
| 41 |
separate DBs - \fBDiddleDB.pdb\fP, containing unnamed `scratch' |
| 42 |
sketches, and \fBDiddleIDB.pdb\fP, containing the saved (and named) |
| 43 |
sketches which are listed by its `index' option. You can feed this |
| 44 |
program any of these three on standard input. |
| 45 |
|
| 46 |
.UN options |
| 47 |
.SH OPTIONS |
| 48 |
.PP |
| 49 |
There are no command line options defined specifically |
| 50 |
for \fBddbugtopbm\fP, but it recognizes the options common to all |
| 51 |
programs based on libnetpbm (See |
| 52 |
.UR index.html#commonoptions |
| 53 |
Common Options |
| 54 |
.UE |
| 55 |
\&.) |
| 56 |
|
| 57 |
.UN using |
| 58 |
.SH USING THE PROGRAM |
| 59 |
.PP |
| 60 |
I recommend you \fInot\fP run \fBddbugtopbm\fP from your Palm |
| 61 |
backup directory, i.e. don't run it from the directory the DB will |
| 62 |
normally be in. Instead, run it from some other directory (perhaps you |
| 63 |
could make a directory purely to hold the PBM files, just to keep |
| 64 |
things simple) and use an absolute or relative path to the DB. |
| 65 |
.PP |
| 66 |
The filenames used for the output PBMs are based on the names given |
| 67 |
to each sketch; if you have an unnamed sketch, it's given a name along |
| 68 |
the lines of \fBsketch-0123.pbm\fP. |
| 69 |
.PP |
| 70 |
While the named sketches will overwrite any existing PBM file with |
| 71 |
the same name, the unnamed ones won't - they'll just try using another |
| 72 |
filename. (I think this is probably the right approach, as you can't |
| 73 |
really tell the unnamed sketches apart.) |
| 74 |
|
| 75 |
|
| 76 |
|
| 77 |
.UN limitations |
| 78 |
.SH LIMITATIONS |
| 79 |
.PP |
| 80 |
The DiddleBug DB reader is only known to work with DBs from |
| 81 |
DiddleBug version 2.50. But it should probably work on later versions, |
| 82 |
and I think it'll work on DBs from version 2.15 as well. |
| 83 |
.PP |
| 84 |
It might fall over if fed an empty database, and doesn't do much |
| 85 |
(if any) checking of the input. |
| 86 |
|
| 87 |
|
| 88 |
.UN author |
| 89 |
.SH AUTHOR |
| 90 |
|
| 91 |
Russell Marks (\[email protected]\fP). |
| 92 |
.PP |
| 93 |
Mitch Blevins's decompression code is directly from DiddleBug |
| 94 |
itself, which like ddbugtopbm is distributed under the terms of the |
| 95 |
GNU GPL. |
| 96 |
|
| 97 |
.UN seealso |
| 98 |
.SH SEE ALSO |
| 99 |
.PP |
| 100 |
.BR "palmtopnm" (1)\c |
| 101 |
\&, |
| 102 |
.BR "pbm" (1)\c |
| 103 |
\& |
| 104 |
.PP |
| 105 |
Jens-Chr. Heyer's `didcon' script does something similar. |
| 106 |
|
| 107 |
.UN history |
| 108 |
.SH HISTORY |
| 109 |
.PP |
| 110 |
\fBddbugtopbm\fP was new in Netpbm 10.18 (August 2003). It was written |
| 111 |
and independently distributed in August 2002. |
| 112 |
.SH DOCUMENT SOURCE |
| 113 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 114 |
source. The master documentation is at |
| 115 |
.IP |
| 116 |
.B http://netpbm.sourceforge.net/doc/ddbugtopbm.html |
| 117 |
.PP |