|
|
1.1 root 1: .TH POSTSCRIPT 8
2: .CT 1 sa_auto
3: .SH NAME
4: dpost, postdaisy, postdmd, postprint \- filters to produce postscript
5: .SH SYNOPSIS
6: .B /usr/bin/postscript/dpost
7: [
8: .I option ...
9: ] [
10: .I file ...
11: ]
12: .PP
13: .B /usr/bin/postscript/postdaisy
14: [
15: .I option ...
16: ] [
17: .I file ...
18: ]
19: .PP
20: .B /usr/bin/postscript/postdmd
21: [
22: .I option ...
23: ] [
24: .I file ...
25: ]
26: .PP
27: .B /usr/bin/postscript/postprint
28: [
29: .I option ...
30: ] [
31: .I file ...
32: ]
33: .PP
34: .B /usr/bin/postscript/posttek
35: [
36: .I option ...
37: ] [
38: .I file ...
39: ]
40: .SH DESCRIPTION
41: These programs convert files of various formats into
42: PostScript.
43: The input formats are
44: .nr xx \w'\fL-p\ \fImode\ 'u
45: .TP \n(xxu
46: .I dpost
47: .IR troff (1)
48: output
49: .TP
50: .I postdaisy
51: Diablo 1640 daisy-wheel
52: .TP
53: .I postdmd
54: .IR bitfile (9.5)
55: files, as produced by
56: .IR blitblt (9.1)
57: .TP
58: .I postprint
59: .SM
60: ASCII
61: text
62: .TP
63: .I posttek
64: Tektronix 4014 graphics
65: .PP
66: Except as noted,
67: the options are common to all the programs:
68: .TP \n(xxu
69: .BI \-c num
70: Print
71: .I num
72: copies of each page.
73: By default only one copy is printed.
74: .TP
75: .BI \-m num
76: Magnify each logical page by the factor
77: .I num.
78: Pages are scaled uniformly about the origin,
79: located near the upper left corner of
80: the page.
81: The default magnification is 1.0.
82: .TP
83: .BI \-n num
84: Print
85: .I num
86: logical pages on each piece of paper.
87: The default is 1.
88: .TP
89: .BI \-o list
90: Print only pages specified in
91: the comma-separated
92: .I list
93: of numbers and ranges.
94: A range
95: .IB N - M
96: means pages
97: .I N
98: through
99: .IR M ;
100: an initial
101: .BI - N
102: means
103: from the beginning to page
104: .IR N ;
105: and a final
106: .IB N -
107: means
108: from
109: .I N
110: to the end.
111: Print only pages whose numbers are given in the comma-separated
112: .IR list .
113: The list contains single numbers
114: .I N
115: and ranges
116: .IB N1 \- N2.
117: A missing
118: .I N1
119: means the lowest numbered page, a missing
120: .I N2
121: means the highest.
122: .TP
123: .BI \-p mode
124: Print
125: in
126: .I mode
127: .B p
128: (portrait)
129: or
130: .B l
131: (landscape).
132: The default is
133: .BR p .
134: .TP
135: .BI \-x num
136: Translate the origin
137: .I num
138: inches along the positive x axis.
139: By default,
140: the origin is
141: fixed near the
142: upper left corner of the page, with positive
143: x to the right and positive y down the page.
144: Positive
145: .I num
146: moves everything right.
147: The default offset is 0 inches.
148: .TP
149: .BI \-y num
150: Translate the origin
151: .I num
152: inches along the positive y axis.
153: Positive
154: .I num
155: moves text down the page.
156: The default offset is 0.
157: .TP
158: .BI \-A file
159: Append a simple accounting record to
160: .I file
161: after all input
162: .I files
163: have been successfully translated.
164: By default no accounting data is produced.
165: .TP
166: .BI \-L file
167: Use
168: .I file
169: as the PostScript prologue.
170: .TP
171: .BI \-f name
172: Print
173: .I files
174: using font
175: .I name.
176: Any PostScript font can be used,
177: but constant width fonts yield the best results.
178: The default font is Courier.
179: .RI ( postdaisy,
180: .IR postprint,
181: and
182: .IR posttek
183: only)
184: .TP
185: .BI \-f
186: Flip the sense of the bits in
187: .I files
188: before printing the bitmaps.
189: .RI ( postdmd
190: only)
191: .PP
192: In addition, three options allow the insertion of arbitrary PostScript
193: at controlled points in the translation process:
194: .TP \n(xxu
195: .BI \-C file
196: Copy
197: .I file
198: to the output file.
199: .I File
200: follows the prologue but
201: precedes any job initialization commands.
202: .I File
203: becomes part of the job's global environment
204: and must contain legitimate PostScript commands.
205: .TP
206: .BI \-P string
207: Like
208: .BR -C ,
209: using a
210: .I string
211: instead of the contents of a file.
212: .TP
213: .BI \-R action
214: Requests special
215: .I action
216: (e.g. manualfeed) on a per page or global basis.
217: The
218: .I action
219: string has the general form
220: .IB request : page : file,
221: from which
222: .BI : page : file
223: or
224: .B : file
225: can be omitted.
226: An omitted or 0 page number
227: applies to all pages.
228: If file is omitted the request
229: lookup is done in
230: .FR /usr/lib/postscript/ps.requests .
231: The collection of recognized requests can be modified or extended
232: by changing this file.
233: Multiple occurrences of the
234: .B \-R
235: option behave as expected.
236: .SH FILES
237: .TF /usr/lib/font/devpost/charlib/*
238: .TP
239: .F /usr/lib/font/devpost/*.out
240: .TP
241: .F /usr/lib/font/devpost/charlib/*
242: .TP
243: .F /usr/lib/postscript/*.ps
244: default prologues
245: .TP
246: .F /usr/lib/tmac/tmac.pictures
247: .I troff
248: macros for PostScript
249: .SH SEE ALSO
250: .IR lp (1),
251: .IR postio (8)
252: .SH DIAGNOSTICS
253: Exit status 2
254: usually means a syntax error in some input file.
255: .SH BUGS
256: Output files
257: will often violate Adobe's
258: file structuring conventions.
259: Pipe the output of
260: .I dpost
261: through
262: .I postreverse
263: to produce a minimally conforming PostScript file.
264: .PP
265: Although
266: .I dpost
267: can handle files formatted for any
268: .IR troff
269: device, emulation is expensive and
270: can easily double the print time and the size of the output file.
271: .PP
272: No attempt has been made to implement the character sets
273: or fonts available on all devices supported by
274: .I troff.
275: Missing characters are replaced by white space;
276: unrecognized fonts are replaced by one of the Times fonts.
277: .PP
278: .I Dpost
279: requires an
280: .B x res
281: command before the first
282: .B x init
283: and any file data.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.