Debian Codegraph @

upstream/debian-unstable/man1/ddbugtopbm.1

raw
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