Commit bcd1d842c80f8ea3ceb32be378151e1845c10456 - pnm2ppa

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, 8 months ago

1 changed file(s) with 64 addition(s) and 64 deletion(s). Raw diff Collapse all Expand all

+64

-64

docs/en/pnm2ppa.1 less more

0		.TH pnm2ppa "23 Jun 2002"
	0	.TH pnm2ppa 1 "23 Jun 2002"
1	1	.SH NAME
2	2	pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer format.
3	3	.SH SYNOPSIS
4		pnm2ppa [options] [ -i \fIinfile\fR ] [ -o \fIoutfile\fR ]
	4	pnm2ppa [options] [ \-i \fIinfile\fR ] [ \-o \fIoutfile\fR ]
5	5
6	6	.SH DESCRIPTION
7	7	Reads portable anymap (PNM) format as input. Binary PNM formats pnmraw =

15	15	GhostScript output devices "pbmraw", "pgmraw" or "ppmraw", or by "pnmraw",
16	16	which will choose one of these formats as appropriate for the document.)
17	17	\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
19	19	resolutions will result in a correspondingly larger/smaller printed image,
20	20	provided it is within the printer's allowed size range.
21	21	.PP
22	22
23	23	.SH OPTIONS
24		.\"{{{ -b bottommargin
	24	.\"{{{ \-b bottommargin
25	25	.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
30	30	.IP "\fB\-B \fIblackness\fR\fP"
31	31	Sets the black ink density \fIblackness\fR in drops per pixel (0,1,2,3,4).
32	32	.\"}}}
33	33
34		.\"{{{ --bi
35		.IP "\fB\--bi\fP"
	34	.\"{{{ \-\-bi
	35	.IP "\fB\-\-bi\fP"
36	36	Force bidirectional print sweeps.
37	37	.\"}}}
38	38
39	39	.\"{{{ --bw
40		.IP "\fB\--bw\fP"
	40	.IP "\fB\-\-bw\fP"
41	41	Disables the color cartridge; will print in grey scale using only the black cartridge.
42	42	.\"}}}
43	43
44		.\"{{{ -d
	44	.\"{{{ \-d
45	45	.IP "\fB\-d\fP"
46	46	Displays the current configuration.
47	47	.\"}}}
48	48
49		.\"{{{ --dpi300
50		.IP "\fB\--dpi300\fP"
	49	.\"{{{ \-\-dpi300
	50	.IP "\fB\-\-dpi300\fP"
51	51	Treat input resolution as 300dpi instead of 600dpi.
52	52	.\"}}}
53	53
54		.\"{{{ --eco
55		.IP "\fB\--eco\fP"
	54	.\"{{{ \-\-eco
	55	.IP "\fB\-\-eco\fP"
56	56	Econofast mode: lower print quality that is faster and saves ink.
57	57	.\"}}}
58	58
59		.\"{{{ -f configFile
	59	.\"{{{ \-f configFile
60	60	.IP "\fB\-f \fIconfigFile\fR\fP"
61	61	Re-reads configuration from \fIconfigFile\fR (after
62	62	initially reading it from /etc/pnm2ppa.conf).
63	63	.\"}}}
64	64
65		.\"{{{ -F GammaFile
	65	.\"{{{ \-F GammaFile
66	66	.IP "\fB\-F \fIGammaFile\fR\fP"
67	67	Overrides reading the color-correction table (Gamma curve) from the default
68	68	file /etc/pnm2ppa.gamma, and uses \fIGammaFile\fR instead.
69	69	.\"}}}
70	70
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
77	77	.IP "\fB\-g\fP"
78	78	Prints a page of color intensity samples (for comparison with gamma.ppm
79	79	data produced by calibrate_ppa).
80	80	This is part of a \fBcolor-correction\fP procedure; see COLOR.txt for more details.
81	81	.\"}}}
82	82
83		.\"{{{ -h, --help
84		.IP "\fB\-h, --help\fP"
	83	.\"{{{ \-h, \-\-help
	84	.IP "\fB\-h, \-\-help\fP"
85	85	Displays program usage.
86	86	.\"}}}
87	87
88		.\"{{{ -i infile
	88	.\"{{{ \-i infile
89	89	.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
94	94	.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"
100	100	Switches off any color-correction.
101	101	.\"}}}
102	102
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
109	109	.IP "\fB\-p\fP"
110	110	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
111	111	color images.
112	112	.\"}}}
113	113
114		.\"{{{ -r rightmargin
	114	.\"{{{ \-r rightmargin
115	115	.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
120	120	.IP "\fB\-s \fIpapersize\fR\fP"
121	121	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).
123	123	In normal use, pnm2ppa now instead reads the paper dimensions from
124	124	pnm input file headers, and
125	125	checks that it is a valid papersize for the given printer model.

129	129	The default is US Letter.
130	130	.\"}}}
131	131
132		.\"{{{ -t topmargin
	132	.\"{{{ \-t topmargin
133	133	.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"
139	139	Force unidirectional (left to right) print sweeps. Useful if
140	140	"shearing" is a problem for high quality color images.
141	141	.\"}}}
142	142
143		.\"{{{ -v printertype
	143	.\"{{{ \-v printertype
144	144	.IP "\fB\-v \fIprintertype\fP"
145	145	Selects the printer model. Possible values of \fIprintertype\fR are:
146	146	\fB710\fP, \fB712\fP, \fB720\fP, \fB722\fP, \fB820\fP and \fB1000\fP.
147	147	The default is the HP DeskJet 7X0 Series (710, 712, 720, 722).
148	148	.\"}}}
149	149
150		.\"{{{ --verbose
151		.IP "\fB\--verbose\fP"
	150	.\"{{{ \-\-verbose
	151	.IP "\fB\-\-verbose\fP"
152	152	Displays the program's System Log messages on the standard output, as well.
153	153	.\"}}}
154	154
155		.\"{{{ --version
156		.IP "\fB\--version\fP"
	155	.\"{{{ \-\-version
	156	.IP "\fB\-\-version\fP"
157	157	Displays the program's version information.
158	158	.\"}}}
159	159
160		.\"{{{ -x xoffset
	160	.\"{{{ \-x xoffset
161	161	.IP "\fB\-x \fIxoffset\fR\fP"
162	162	Sets the x-offset \fIxoffset\fR from the left of the page. Units are 1/600 inches.
163	163	.\"}}}
164	164
165		.\"{{{ -y yoffset
	165	.\"{{{ \-y yoffset
166	166	.IP "\fB\-y \fIyoffset\fR\fP"
167	167	Sets the y-offset \fIyoffset\fR from the top of the page. Units are 1/600 inches.
168	168	.\"}}}

171	171	.SH NOTES
172	172	The default configuration file \fI/etc/pnm2ppa.conf\fR is read in first. Command line arguments then modify the resulting definitions.
173	173	.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
175	175	the inbuilt defaults for that printer and should be used before subsequent
176	176	\fB-b\fP, \fB-l\fP, \fB-r\fP, \fB-t\fP, \fB-x\fP and \fB-y\fP arguments.
177	177	.SH "SEE ALSO"

211	211	.SH BUGS
212	212	Faint horizontal lines marking boundaries between print sweeps may be visible.
213	213	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