| blob | c977e416ad155c4fbf0e79d295ab91f9fad1d533 |
1 '\" te
2 .\" Copyright 1989 AT&T Copyright (c) 1996 Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH DPOST 1 "May 13, 2017"
7 .SH NAME
8 dpost \- troff postprocessor for PostScript printers
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBdpost\fR [\fB-c\fR \fInum\fR] [\fB-e\fR \fInum\fR] [\fB-m\fR \fInum\fR] [\fB-n\fR \fInum\fR] [\fB-o\fR \fIlist\fR]
13 [\fB-w\fR \fInum\fR] [\fB-x\fR \fInum\fR] [\fB-y\fR \fInum\fR] [\fB-F\fR \fIdir\fR] [\fB-H\fR \fIdir\fR]
14 [\fB-L\fR \fIfile\fR] [\fB-O\fR] [\fB-T\fR \fIname\fR] [\fIfile\fR]...
15 .fi
17 .LP
18 .nf
19 \fB/usr/lib/lp/postscript/dpost\fR
20 .fi
22 .SH DESCRIPTION
23 .LP
24 \fBdpost\fR translates \fIfiles\fR created by \fBtroff\fR(1) into PostScript
25 and writes the results on the standard output. If no \fIfiles\fR are specified,
26 or if \(mi is one of the input \fIfiles\fR, the standard input is read.
27 .sp
28 .LP
29 The \fIfiles\fR should be prepared by \fBtroff\fR. The default font files in
30 \fB/usr/lib/font/devpost\fR produce the best and most efficient output. They
31 assume a resolution of 720 dpi, and can be used to format files by adding the
32 \fB-Tpost\fR option to the \fBtroff\fR call. Older versions of the \fBeqn\fR
33 and \fBpic\fR preprocessors need to know the resolution that \fBtroff\fR will
34 be using to format the \fIfiles\fR. If those are the versions installed on your
35 system, use the \fB-r720\fR option with \fBeqn\fR and \fB-T720\fR with
36 \fBpic\fR.
37 .sp
38 .LP
39 \fBdpost\fR makes no assumptions about resolutions. The first \fBx res\fR
40 command sets the resolution used to translate the input \fIfiles\fR, the
41 \fBDESC.out\fR file, usually \fB/usr/lib/font/devpost/DESC.out\fR, defines the
42 resolution used in the binary font files, and the PostScript prologue is
43 responsible for setting up an appropriate user coordinate system.
44 .SH OPTIONS
45 .ne 2
46 .na
47 \fB\fB-c\fR\fI num\fR\fR
48 .ad
49 .RS 11n
50 Print \fInum\fR copies of each page. By default only one copy is printed.
51 .RE
53 .sp
54 .ne 2
55 .na
56 \fB\fB-e\fR\fI num\fR\fR
57 .ad
58 .RS 11n
59 Sets the text encoding level to \fInum\fR. The recognized choices are 0, 1, and
60 2. The size of the output file and print time should decrease as \fInum\fR
61 increases. Level 2 encoding will typically be about 20 percent faster than
62 level 0, which is the default and produces output essentially identical to
63 previous versions of \fBdpost\fR.
64 .RE
66 .sp
67 .ne 2
68 .na
69 \fB\fB-m\fR\fI num\fR\fR
70 .ad
71 .RS 11n
72 Magnify each logical page by the factor \fInum\fR. Pages are scaled uniformly
73 about the origin, which is located near the upper left corner of each page. The
74 default magnification is \fB1.0\fR.
75 .RE
77 .sp
78 .ne 2
79 .na
80 \fB\fB-n\fR\fI num\fR\fR
81 .ad
82 .RS 11n
83 Print \fInum\fR logical pages on each piece of paper, where \fInum\fR can be
84 any positive integer. By default, \fInum\fR is set to \fB1\fR.
85 .RE
87 .sp
88 .ne 2
89 .na
90 \fB\fB-o\fR\fI list\fR\fR
91 .ad
92 .RS 11n
93 Print those pages for which numbers are given in the comma-separated
94 \fIlist\fR. The list contains single numbers \fIN\fR and ranges
95 \fIN1\fR\fB\(mi\fR\fIN2.\fR A missing \fIN1\fR means the lowest numbered page,
96 a missing \fIN2\fR means the highest. The page range is an expression of
97 logical pages rather than physical sheets of paper. For example, if you are
98 printing two logical pages to a sheet, and you specified a range of \fB4\fR,
99 then two sheets of paper would print, containing four page layouts. If you
100 specified a page range of \fB 3-4\fR, when requesting two logical pages to a
101 sheet; then \fIonly\fR page 3 and page 4 layouts would print, and they would
102 appear on one physical sheet of paper.
103 .RE
105 .sp
106 .ne 2
107 .na
108 \fB\fB-p\fR\fI mode\fR\fR
109 .ad
110 .RS 11n
111 Print \fIfiles\fR in either portrait or landscape \fImode\fR. Only the first
112 character of \fImode\fR is significant. The default \fImode\fR is portrait.
113 .RE
115 .sp
116 .ne 2
117 .na
118 \fB\fB-w\fR\fI num\fR\fR
119 .ad
120 .RS 11n
121 Set the line width used to implement \fBtroff\fR graphics commands to \fInum\fR
122 points, where a point is approximately 1/72 of an inch. By default, \fInum\fR
123 is set to \fB0.3\fR points.
124 .RE
126 .sp
127 .ne 2
128 .na
129 \fB\fB-x\fR\fI num\fR\fR
130 .ad
131 .RS 11n
132 Translate the origin \fInum\fR inches along the positive x axis. The default
133 coordinate system has the origin fixed near the upper left corner of the page,
134 with positive x to the right and positive y down the page. Positive \fInum\fR
135 moves everything right. The default offset is \fB0\fR inches.
136 .RE
138 .sp
139 .ne 2
140 .na
141 \fB\fB-y\fR\fI num\fR\fR
142 .ad
143 .RS 11n
144 Translate the origin \fInum\fR inches along the positive y axis. Positive
145 \fInum\fR moves text up the page. The default offset is \fB0\fR.
146 .RE
148 .sp
149 .ne 2
150 .na
151 \fB\fB-F\fR\fI dir\fR\fR
152 .ad
153 .RS 11n
154 Use \fIdir\fR as the font directory. The default \fIdir\fR is
155 \fB/usr/lib/font\fR, and \fBdpost\fR reads binary font files from directory
156 \fB/usr/lib/font/devpost\fR.
157 .RE
159 .sp
160 .ne 2
161 .na
162 \fB\fB-H\fR\fI dir\fR\fR
163 .ad
164 .RS 11n
165 Use \fIdir\fR as the host resident font directory. Files in this directory
166 should be complete PostScript font descriptions, and must be assigned a name
167 that corresponds to the appropriate two-character \fBtroff\fR font name. Each
168 font file is copied to the output file only when needed and at most once during
169 each job. There is no default directory.
170 .RE
172 .sp
173 .ne 2
174 .na
175 \fB\fB-L\fR\fI file\fR\fR
176 .ad
177 .RS 11n
178 Use \fBfile\fR as the PostScript prologue which, by default, is
179 \fB/usr/lib/lp/postscript/dpost.ps\fR.
180 .RE
182 .sp
183 .ne 2
184 .na
185 \fB\fB-O\fR\fR
186 .ad
187 .RS 11n
188 Disables PostScript picture inclusion. A recommended option when \fBdpost\fR is
189 run by a spooler in a networked environment.
190 .RE
192 .sp
193 .ne 2
194 .na
195 \fB\fB-T\fR\fI name\fR\fR
196 .ad
197 .RS 11n
198 Use font files for device \fIname\fR as the best description of available
199 PostScript fonts. By default, \fIname\fR is set to \fBpost\fR and \fBdpost\fR
200 reads binary files from \fB/usr/lib/font/devpost\fR.
201 .RE
203 .SH EXAMPLES
204 .LP
205 \fBExample 1 \fRExamples of the \fBdpost\fR command.
206 .sp
207 .LP
208 If the old versions of \fBeqn\fR and \fBpic\fR are installed on your system,
209 you can obtain the best possible looking output by issuing a command line such
210 as the following:
212 .sp
213 .in +2
214 .nf
215 example% \fBpic \fR\fB-T720\fR\fB \fR\fBfile\fR\fB | tbl | eqn \fR\fB-r720\fR\fB | troff \fR\fB-mm\fR\fB \fR\fB-Tpost\fR\fB | dpost\fR
216 .fi
217 .in -2
218 .sp
220 .sp
221 .LP
222 Otherwise,
224 .sp
225 .in +2
226 .nf
227 example% \fBpic \fR\fBfile\fR\fB | tbl | eqn | troff \fR\fB-mm\fR\fB \fR\fB-Tpost\fR\fB | dpost\fR
228 .fi
229 .in -2
230 .sp
232 .sp
233 .LP
234 should give the best results.
236 .SH EXIT STATUS
237 .LP
238 The following exit values are returned:
239 .sp
240 .ne 2
241 .na
242 \fB\fB0\fR\fR
243 .ad
244 .RS 12n
245 Successful completion.
246 .RE
248 .sp
249 .ne 2
250 .na
251 \fBnon-zero\fR
252 .ad
253 .RS 12n
254 An error occurred.
255 .RE
257 .SH FILES
258 .ne 2
259 .na
260 \fB\fB/usr/lib/font/devpost/*.out\fR\fR
261 .ad
262 .sp .6
263 .RS 4n
265 .RE
267 .sp
268 .ne 2
269 .na
270 \fB\fB/usr/lib/font/devpost/charlib/*\fR\fR
271 .ad
272 .sp .6
273 .RS 4n
275 .RE
277 .sp
278 .ne 2
279 .na
280 \fB\fB/usr/lib/lp/postscript/color.ps\fR\fR
281 .ad
282 .sp .6
283 .RS 4n
285 .RE
287 .sp
288 .ne 2
289 .na
290 \fB\fB/usr/lib/lp/postscript/draw.ps\fR\fR
291 .ad
292 .sp .6
293 .RS 4n
295 .RE
297 .sp
298 .ne 2
299 .na
300 \fB\fB/usr/lib/lp/postscript/forms.ps\fR\fR
301 .ad
302 .sp .6
303 .RS 4n
305 .RE
307 .sp
308 .ne 2
309 .na
310 \fB\fB/usr/lib/lp/postscript/ps.requests\fR\fR
311 .ad
312 .sp .6
313 .RS 4n
315 .RE
317 .SH SEE ALSO
318 .LP
319 \fBdownload\fR(1), \fBpostio\fR(1), \fBpostprint\fR(1), \fBpostreverse\fR(1),
320 \fBtroff\fR(1), \fBattributes\fR(5)
321 .SH NOTES
322 .LP
323 Output files often do not conform to Adobe's file structuring conventions.
324 Piping the output of \fBdpost\fR(1) through \fBpostreverse\fR(1) should produce
325 a minimally conforming PostScript file.
326 .sp
327 .LP
328 Although \fBdpost\fR can handle files formatted for any device, emulation is
329 expensive and can easily double the print time and the size of the output file.
330 No attempt has been made to implement the character sets or fonts available on
331 all devices supported by \fBtroff\fR. Missing characters will be replaced by
332 white space, and unrecognized fonts will usually default to one of the Times
333 fonts (that is, \fBR\fR, \fBI\fR, \fBB\fR, or \fBBI\fR).
334 .sp
335 .LP
336 An \fBx res\fR command must precede the first \fBx init\fR command, and all
337 the input \fIfiles\fR should have been prepared for the same output device.
338 .sp
339 .LP
340 Use of the \fB-T\fR option is not encouraged. Its only purpose is to enable the
341 use of other PostScript font and device description files, that perhaps use
342 different resolutions, character sets, or fonts.
343 .sp
344 .LP
345 Although level 0 encoding is the only scheme that has been thoroughly tested,
346 level 2 is fast and may be worth a try.