Package list pnm2ppa / 5d07c43
Fix various errors in the pnm2ppa manpage. Amongst those: hyphen-used-as-minus from lintian and the lack of section identifier. Last-Update: 2011-05-26 Gbp-Pq: Name 0003-Fix-various-errors-in-the-pnm2ppa-manpage.patch Didier Raboud 1 year, 2 days ago
1 changed file(s) with 64 addition(s) and 64 deletion(s). Raw diff Collapse all Expand all
0 .TH pnm2ppa "23 Jun 2002"
0 .TH pnm2ppa 1 "23 Jun 2002"
11 .SH NAME
22 pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer format.
33 .SH SYNOPSIS
4 pnm2ppa [options] [ -i \fIinfile\fR ] [ -o \fIoutfile\fR ]
4 pnm2ppa [options] [ \-i \fIinfile\fR ] [ \-o \fIoutfile\fR ]
55
66 .SH DESCRIPTION
77 Reads portable anymap (PNM) format as input. Binary PNM formats pnmraw =
1515 GhostScript output devices "pbmraw", "pgmraw" or "ppmraw", or by "pnmraw",
1616 which will choose one of these formats as appropriate for the document.)
1717 \fBpnm2ppa\fP assumes the input resolution is 600dpi (or 300dpi if
18 the command-line option \fB--dpi300\fP is used): input at higher/lower
18 the command-line option \fB\-\-dpi300\fP is used): input at higher/lower
1919 resolutions will result in a correspondingly larger/smaller printed image,
2020 provided it is within the printer's allowed size range.
2121 .PP
2222
2323 .SH OPTIONS
24 .\"{{{ -b bottommargin
24 .\"{{{ \-b bottommargin
2525 .IP "\fB\-b \fIbottommargin\fR\fP"
26 Sets the bottom margin \fIbottommargin\fR in units of 1/600 inches (e.g., \fB -b 150\fP corresponds to 0.25").
27 .\"}}}
28
29 .\"{{{ -B blackness
26 Sets the bottom margin \fIbottommargin\fR in units of 1/600 inches (e.g., \fB \-b 150\fP corresponds to 0.25").
27 .\"}}}
28
29 .\"{{{ \-B blackness
3030 .IP "\fB\-B \fIblackness\fR\fP"
3131 Sets the black ink density \fIblackness\fR in drops per pixel (0,1,2,3,4).
3232 .\"}}}
3333
34 .\"{{{ --bi
35 .IP "\fB\--bi\fP"
34 .\"{{{ \-\-bi
35 .IP "\fB\-\-bi\fP"
3636 Force bidirectional print sweeps.
3737 .\"}}}
3838
3939 .\"{{{ --bw
40 .IP "\fB\--bw\fP"
40 .IP "\fB\-\-bw\fP"
4141 Disables the color cartridge; will print in grey scale using only the black cartridge.
4242 .\"}}}
4343
44 .\"{{{ -d
44 .\"{{{ \-d
4545 .IP "\fB\-d\fP"
4646 Displays the current configuration.
4747 .\"}}}
4848
49 .\"{{{ --dpi300
50 .IP "\fB\--dpi300\fP"
49 .\"{{{ \-\-dpi300
50 .IP "\fB\-\-dpi300\fP"
5151 Treat input resolution as 300dpi instead of 600dpi.
5252 .\"}}}
5353
54 .\"{{{ --eco
55 .IP "\fB\--eco\fP"
54 .\"{{{ \-\-eco
55 .IP "\fB\-\-eco\fP"
5656 Econofast mode: lower print quality that is faster and saves ink.
5757 .\"}}}
5858
59 .\"{{{ -f configFile
59 .\"{{{ \-f configFile
6060 .IP "\fB\-f \fIconfigFile\fR\fP"
6161 Re-reads configuration from \fIconfigFile\fR (after
6262 initially reading it from /etc/pnm2ppa.conf).
6363 .\"}}}
6464
65 .\"{{{ -F GammaFile
65 .\"{{{ \-F GammaFile
6666 .IP "\fB\-F \fIGammaFile\fR\fP"
6767 Overrides reading the color-correction table (Gamma curve) from the default
6868 file /etc/pnm2ppa.gamma, and uses \fIGammaFile\fR instead.
6969 .\"}}}
7070
71 .\"{{{ --fd
72 .IP "\fB\--fd\fP"
73 Enable fast ordered dithering instead of using the slower, but beautiful, Floyd-Steinberg dithering. (Has no effect in --bw mode.)
74 .\"}}}
75
76 .\"{{{ -g
71 .\"{{{ \-\-fd
72 .IP "\fB\-\-fd\fP"
73 Enable fast ordered dithering instead of using the slower, but beautiful, Floyd-Steinberg dithering. (Has no effect in \-\-bw mode.)
74 .\"}}}
75
76 .\"{{{ \-g
7777 .IP "\fB\-g\fP"
7878 Prints a page of color intensity samples (for comparison with gamma.ppm
7979 data produced by calibrate_ppa).
8080 This is part of a \fBcolor-correction\fP procedure; see COLOR.txt for more details.
8181 .\"}}}
8282
83 .\"{{{ -h, --help
84 .IP "\fB\-h, --help\fP"
83 .\"{{{ \-h, \-\-help
84 .IP "\fB\-h, \-\-help\fP"
8585 Displays program usage.
8686 .\"}}}
8787
88 .\"{{{ -i infile
88 .\"{{{ \-i infile
8989 .IP "\fB\-i \fIinfile\fR\fP"
90 Input file \fIinfile\fR is either a path to a PPM file, or '-' to indicate stdin (defaults to stdin).
91 .\"}}}
92
93 .\"{{{ -l leftmargin
90 Input file \fIinfile\fR is either a path to a PPM file, or '\-' to indicate stdin (defaults to stdin).
91 .\"}}}
92
93 .\"{{{ \-l leftmargin
9494 .IP "\fB\-l \fIleftmargin\fR\fP"
95 Sets the left margin \fIleftmargin\fR in units of 1/600 inches (e.g., \fB-l 150\fP corresponds to 0.25").
96 .\"}}}
97
98 .\"{{{ --noGamma
99 .IP "\fB\--noGamma\fP"
95 Sets the left margin \fIleftmargin\fR in units of 1/600 inches (e.g., \fB\-l 150\fP corresponds to 0.25").
96 .\"}}}
97
98 .\"{{{ \-\-noGamma
99 .IP "\fB\-\-noGamma\fP"
100100 Switches off any color-correction.
101101 .\"}}}
102102
103 .\"{{{ -o outfile | -
104 .IP "\fB\-o \fIoutfile\fR | - \fP"
105 Output file \fIoutfile\fR is either a path to a file or device, or '-' to indicate stdout (defaults to stdout).
106 .\"}}}
107
108 .\"{{{ -p
103 .\"{{{ \-o outfile | \-
104 .IP "\fB\-o \fIoutfile\fR | \- \fP"
105 Output file \fIoutfile\fR is either a path to a file or device, or '\-' to indicate stdout (defaults to stdout).
106 .\"}}}
107
108 .\"{{{ \-p
109109 .IP "\fB\-p\fP"
110110 Disables the black ink cartridge; i.e., print using only the color ink cartridge, even for printing "black". This might be useful for printing high-quality
111111 color images.
112112 .\"}}}
113113
114 .\"{{{ -r rightmargin
114 .\"{{{ \-r rightmargin
115115 .IP "\fB\-r \fIrightmargin\fR\fP"
116 Sets the right margin \fIrightmargin\fR in units of 1/600 inches (e.g., \fB-r 150\fP corresponds to 0.25").
117 .\"}}}
118
119 .\"{{{ -s papersize
116 Sets the right margin \fIrightmargin\fR in units of 1/600 inches (e.g., \fB\-r 150\fP corresponds to 0.25").
117 .\"}}}
118
119 .\"{{{ \-s papersize
120120 .IP "\fB\-s \fIpapersize\fR\fP"
121121 Sets the default paper size (now used only for color-correction output
122 produced by the \fB-g\fP option).
122 produced by the \fB\-g\fP option).
123123 In normal use, pnm2ppa now instead reads the paper dimensions from
124124 pnm input file headers, and
125125 checks that it is a valid papersize for the given printer model.
129129 The default is US Letter.
130130 .\"}}}
131131
132 .\"{{{ -t topmargin
132 .\"{{{ \-t topmargin
133133 .IP "\fB\-t \fItopmargin\fR\fP"
134 Sets the top margin \fItopmargin\fR in units of 1/600 inches (ie \fB-t 150\fP corresponds to 0.25").
135 .\"}}}
136
137 .\"{{{ --uni
138 .IP "\fB\--uni\fP"
134 Sets the top margin \fItopmargin\fR in units of 1/600 inches (ie \fB\-t 150\fP corresponds to 0.25").
135 .\"}}}
136
137 .\"{{{ \-\-uni
138 .IP "\fB\-\-uni\fP"
139139 Force unidirectional (left to right) print sweeps. Useful if
140140 "shearing" is a problem for high quality color images.
141141 .\"}}}
142142
143 .\"{{{ -v printertype
143 .\"{{{ \-v printertype
144144 .IP "\fB\-v \fIprintertype\fP"
145145 Selects the printer model. Possible values of \fIprintertype\fR are:
146146 \fB710\fP, \fB712\fP, \fB720\fP, \fB722\fP, \fB820\fP and \fB1000\fP.
147147 The default is the HP DeskJet 7X0 Series (710, 712, 720, 722).
148148 .\"}}}
149149
150 .\"{{{ --verbose
151 .IP "\fB\--verbose\fP"
150 .\"{{{ \-\-verbose
151 .IP "\fB\-\-verbose\fP"
152152 Displays the program's System Log messages on the standard output, as well.
153153 .\"}}}
154154
155 .\"{{{ --version
156 .IP "\fB\--version\fP"
155 .\"{{{ \-\-version
156 .IP "\fB\-\-version\fP"
157157 Displays the program's version information.
158158 .\"}}}
159159
160 .\"{{{ -x xoffset
160 .\"{{{ \-x xoffset
161161 .IP "\fB\-x \fIxoffset\fR\fP"
162162 Sets the x-offset \fIxoffset\fR from the left of the page. Units are 1/600 inches.
163163 .\"}}}
164164
165 .\"{{{ -y yoffset
165 .\"{{{ \-y yoffset
166166 .IP "\fB\-y \fIyoffset\fR\fP"
167167 Sets the y-offset \fIyoffset\fR from the top of the page. Units are 1/600 inches.
168168 .\"}}}
171171 .SH NOTES
172172 The default configuration file \fI/etc/pnm2ppa.conf\fR is read in first. Command line arguments then modify the resulting definitions.
173173 .PP
174 The \fB-v\fP option resets all definitions (margins, offsets, etc.) back to
174 The \fB\-v\fP option resets all definitions (margins, offsets, etc.) back to
175175 the inbuilt defaults for that printer and should be used before subsequent
176176 \fB-b\fP, \fB-l\fP, \fB-r\fP, \fB-t\fP, \fB-x\fP and \fB-y\fP arguments.
177177 .SH "SEE ALSO"
211211 .SH BUGS
212212 Faint horizontal lines marking boundaries between print sweeps may be visible.
213213 You may get better results when printing images, with the options:
214 \fB -p --uni \fP (this may no longer apply since recent code improvements).
215
214 \fB \-p \-\-uni \fP (this may no longer apply since recent code improvements).
215