![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to dpost.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / postscript / dpost|
Return to dpost.1 CVS log | Up to [Research Unix] / researchv10no / cmd / postscript / dpost |
1.1 root 1: .ds dF /usr/lib/font
2: .ds dQ /usr/lib/postscript
3: .TH DPOST 1 "DWB 3.2"
4: .SH NAME
5: .B dpost
6: \-
7: .B troff
8: postprocessor for PostScript printers
9: .SH SYNOPSIS
10: \*(mBdpost\f1
11: .OP "" options []
12: .OP "" files []
13: .SH DESCRIPTION
14: .B dpost
15: translates
16: .I files
17: created by
18: .BR troff (1)
19: into PostScript and writes the results on the
20: standard output.
21: If no
22: .I files
23: are specified, or if
24: .OP \-
25: is one of the input
26: .IR files ,
27: the standard input is read.
28: The following
29: .I options
30: are understood:
31: .TP 0.75i
32: .OP \-c num
33: Print
34: .I num
35: copies of each page.
36: By default only one copy is printed.
37: .TP
38: .OP \-m num
39: Magnify each logical page by the factor
40: .IR num
41: (default is 1.0).
42: Pages are scaled uniformly about the origin,
43: which is located near the upper left corner of
44: each page.
45: .TP
46: .OP \-n num
47: Print
48: .I num
49: logical pages on each piece of paper,
50: where
51: .I num
52: can be any positive integer.
53: By default,
54: .I num
55: is set to 1.
56: .TP
57: .OP \-o list
58: Print pages whose numbers are given in the comma-separated
59: .IR list .
60: The list contains single numbers
61: .I N
62: and ranges
63: .IR N1\-\|N2 .
64: A missing
65: .I N1
66: means the lowest numbered page, a missing
67: .I N2
68: means the highest.
69: .TP
70: .OP \-p mode
71: Print
72: .I files
73: in either \*(mBportrait\fP or \*(mBlandscape\fP mode.
74: Only the first character of
75: .I mode
76: is significant.
77: The default
78: .I mode
79: is \*(mBportrait\fP.
80: .TP
81: .OP \-w num
82: Set the line width used to implement
83: .B troff
84: graphics commands to
85: .I num
86: points, where a point is approximately 1/72
87: of an inch.
88: By default
89: .I num
90: is set to 0.3 points.
91: .TP
92: .OP \-x num
93: Translate the origin
94: .I num
95: inches along the positive x axis.
96: The default
97: coordinate system has the origin fixed near the
98: upper left corner of the page, with positive
99: x to the right and positive y down the page.
100: Positive
101: .I num
102: moves everything right.
103: The default offset is 0 inches.
104: .TP
105: .OP \-y num
106: Translate the origin
107: .I num
108: inches along the positive y axis.
109: Positive
110: .I num
111: moves text down the page.
112: The default offset is 0.
113: .TP
114: .OP \-B
115: Include
116: .MW %%BoundingBox
117: comments in the output file.
118: Should only be used when the comments are needed
119: for picture inclusion.
120: Output is forced onto an 8.5\(mu11-inch page.
121: .TP
122: .OP \-E name
123: Set the character encoding for text fonts to
124: .IR name .
125: Requesting
126: .I name
127: means include file
128: .MI \*(dQ/ name .enc \f1.
129: A nonexistent encoding file is silently ignored.
130: There is no default.
131: .TP
132: .OP \-F dir
133: Use
134: .I dir
135: as the font directory.
136: The default
137: .I dir
138: is
139: .MR \*(dF ,
140: and
141: .B dpost
142: reads
143: .SM ASCII
144: font files from directory
145: .MR \*(dF/devpost .
146: .TP
147: .OP \-H dir
148: Use
149: .I dir
150: as the host-resident font directory.
151: A file in
152: .I dir
153: that matches the name of the
154: .B troff
155: font is assumed to be a host resident font program
156: and is included in
157: .B dpost
158: output.
159: There is no default.
160: .TP
161: .OP \-L \^file
162: Use
163: .I file
164: as the PostScript prologue.
165: The default is
166: .MR \*(dQ/dpost.ps .
167: .TP
168: .OP \-T name
169: Use font files for device
170: .I name
171: as the best description of available PostScript fonts.
172: By default,
173: .I name
174: is
175: \*(mBpost\fP
176: and
177: .B dpost
178: reads
179: .SM ASCII
180: files from
181: .MR \*(dF/devpost .
182: .br
183: .ne 1i
184: .PP
185: Three options allow insertion of arbitrary PostScript
186: at controlled points in the translation process:
187: .TP 0.75i
188: .OP \-C \^file
189: Copy
190: .I file
191: to the output file;
192: .I file
193: must contain legitimate PostScript.
194: .TP
195: .OP \-P string
196: Include
197: .I string
198: in the output file;
199: .I string
200: must be legitimate PostScript.
201: .TP
202: .OP \-R action
203: Requests special
204: .I action
205: (e.g.,
206: .MR manualfeed )
207: on a per page or global basis.
208: The
209: .I action
210: string can be given as
211: .IR request \|,
212: .IM request : page\f1\|,
213: or
214: .IM request : page : file\f1\|.
215: If
216: .I page
217: is omitted or given as 0 the request
218: applies to all pages.
219: If
220: .I file
221: is omitted the request
222: lookup is done in
223: .MR \*(dQ/ps.requests .
224: .PP
225: All
226: .I files
227: should be prepared by
228: .B troff
229: for the same device.
230: Device tables that describe real PostScript fonts that can be
231: used by
232: .B dpost
233: should include
234: .EX
235: PDL PostScript
236: .EE
237: in their
238: .SM DESC
239: file.
240: Tables that depend on a non-standard character set encoding indicate
241: that fact by an
242: .MW Encoding
243: entry in their
244: .SM DESC
245: file.
246: For example,
247: .EX
248: Encoding Latin1
249: .EE
250: means include file
251: .MR \*(dQ/Latin1.enc .
252: The
253: .OP \-E
254: option overrides the
255: .SM DESC
256: setting.
257: .SH EXAMPLES
258: .PP
259: A typical command line might be:
260: .EX
261: pic \f2files\fP | tbl | eqn | troff -mm | dpost
262: .EE
263: .SH DIAGNOSTICS
264: A 0 exit status is returned if
265: .I files
266: were successfully translated,
267: while 2 often indicates a syntax error in the input
268: .IR files .
269: .SH WARNINGS
270: .PP
271: .B dpost
272: output does not usually conform to Adobe's file-structuring conventions.
273: Send the output through
274: .B postreverse
275: to produce a minimally conforming PostScript file.
276: .PP
277: Emulation is expensive and does not always produce satisfactory results.
278: No attempt has been made to implement the character sets or fonts available
279: on all devices supported by
280: .BR troff .
281: Missing characters are replaced by white space, and unrecognized
282: fonts default to one of the Times fonts (e.g.,
283: .MR R ,
284: .MR I ,
285: .MR B ,
286: or
287: .MR BI ).
288: .SH FILES
289: .MW \*(dF/devpost/*
290: .br
291: .MW \*(dF/devpost/charlib/*
292: .br
293: .MW \*(dQ/dpost.ps
294: .br
295: .MW \*(dQ/color.ps
296: .br
297: .MW \*(dQ/draw.ps
298: .br
299: .MW \*(dQ/forms.ps
300: .br
301: .MW \*(dQ/ps.requests
302: .SH SEE ALSO
303: .BR buildtables (1),
304: .BR postio (1),
305: .BR postprint (1),
306: .BR postreverse (1),
307: .BR psencoding (1),
308: .BR troff (1),
309: .BR font (5),
310: .BR troff (5)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.