|
|
1.1 root 1: .ds dQ /usr/lib/postscript
2: .TH POSTPRINT 1 "DWB 3.2"
3: .SH NAME
4: .B postprint
5: \- PostScript translator for text files
6: .SH SYNOPSIS
7: \*(mBpostprint\f1
8: .OP "" options []
9: .OP "" files []
10: .SH DESCRIPTION
11: .B postprint
12: translates text
13: .I files
14: into PostScript and writes the results on the
15: standard output.
16: If no
17: .I files
18: are specified, or if
19: .OP \-
20: is one of the input
21: .IR files ,
22: the standard input is read.
23: The following
24: .I options
25: are understood:
26: .TP 0.75i
27: .OP \-c num
28: Print
29: .I num
30: copies of each page.
31: By default only one copy is printed.
32: .TP
33: .OP \-f name
34: Print
35: .I files
36: using font
37: .IR name .
38: Any PostScript font can be used,
39: although the best results will only be
40: obtained with constant width fonts.
41: The default font is Courier.
42: .TP
43: .OP \-l num
44: Set the length of a page to
45: .I num
46: lines.
47: By default
48: .I num
49: is 66.
50: Setting
51: .I num
52: to 0 is allowed, and will cause
53: .B postprint
54: to guess a value, based on the point size that is being used.
55: .TP
56: .OP \-m num
57: Magnify each logical page by the factor
58: .IR num .
59: Pages are scaled uniformly about the origin,
60: which is located near the upper left corner of
61: each page.
62: The default magnification is 1.0.
63: .TP
64: .OP \-n num
65: Print
66: .I num
67: logical pages on each piece of paper,
68: where
69: .I num
70: can be any positive integer.
71: By default
72: .I num
73: is set to 1.
74: .TP
75: .OP \-o list
76: Print pages whose numbers are given in the comma-separated
77: .IR list .
78: The list contains single numbers
79: .I N
80: and ranges
81: .IR N1\-\|N2 .
82: A missing
83: .I N1
84: means the lowest numbered page, a missing
85: .I N2
86: means the highest.
87: .TP
88: .OP \-p mode
89: Print
90: .I files
91: in either \*(mBportrait\fP or \*(mBlandscape\fP
92: .IR mode .
93: Only the first character of
94: .I mode
95: is significant.
96: The default
97: .I mode
98: is \*(mBportrait\fP.
99: .TP
100: .OP \-r num
101: Selects carriage return behavior.
102: Carriage returns are ignored if
103: .I num
104: is 0,
105: cause a return to column 1 if
106: .I num
107: is 1,
108: and generate a newline if
109: .I num
110: is 2.
111: The default
112: .I num
113: is 0.
114: .TP
115: .OP \-s num
116: Print
117: .I files
118: using point size
119: .IR num .
120: When printing in landscape mode
121: .I num
122: is scaled by a factor that depends on the
123: imaging area of the device.
124: The default size for portrait mode is 10.
125: .TP
126: .OP \-t num
127: Assume tabs are set every
128: .I num
129: columns, starting with the first column.
130: By default tabs are set every 8 columns.
131: .TP
132: .OP \-x num
133: Translate the origin
134: .I num
135: inches along the positive x axis.
136: The default
137: coordinate system has the origin fixed near the
138: upper left corner of the page, with positive
139: x to the right and positive y down the page.
140: Positive
141: .I num
142: moves everything right.
143: The default offset is 0.25 inches.
144: .TP
145: .OP \-y num
146: Translate the origin
147: .I num
148: inches along the positive y axis.
149: Positive
150: .I num
151: moves text down the page.
152: The default offset is 0.25 inches.
153: .TP
154: .OP \-E name
155: Set the character encoding for text fonts to
156: .IR name .
157: Requesting
158: .I name
159: means include file
160: .MI \*(dQ/ name .enc \f1.
161: A nonexistent encoding file is silently ignored.
162: The default selects file
163: .MR \*(dQ/Default.enc .
164: .TP
165: .OP \-L file
166: Use
167: .I file
168: as the PostScript prologue.
169: .br
170: The default is
171: .MR \*(dQ/postprint.ps .
172: .PP
173: Three options allow insertion of arbitrary PostScript
174: at controlled points in the translation process:
175: .TP 0.75i
176: .OP \-C file
177: Copy
178: .I file
179: to the output file;
180: .I file
181: must contain legitimate PostScript.
182: .TP
183: .OP \-P string
184: Include
185: .I string
186: in the output file;
187: .I string
188: must be legitimate PostScript.
189: .TP
190: .OP \-R action
191: Requests special
192: .I action
193: (e.g.,
194: .MR manualfeed )
195: on a per page or global basis.
196: The
197: .I action
198: string can be given as
199: .IR request ,
200: .IM request : page\f1\|,
201: or
202: .IM request : page : file\f1\|.
203: If
204: .I page
205: is omitted or given as 0, the request
206: applies to all pages.
207: If
208: .I file
209: is omitted, the request
210: lookup is done in
211: .MR \*(dQ/ps.requests .
212: .PP
213: A new logical page is started after 66 lines have been printed
214: on the current page, or whenever an
215: .SM ASCII
216: form feed character is read.
217: The number of lines per page can be changed using the
218: .OP \-l
219: option.
220: Unprintable
221: .SM ASCII
222: characters are ignored,
223: and lines that are too long are silently truncated
224: by the printer.
225: .SH EXAMPLES
226: .PP
227: Print
228: .I file1
229: and
230: .I file2
231: in landscape mode:
232: .EX
233: postprint -pland \f2file1 file2
234: .EE
235: Print three logical pages on each physical page in portrait mode:
236: .EX
237: postprint -n3 \f2file
238: .EE
239: .SH DIAGNOSTICS
240: A 0 exit status is returned if
241: .I files
242: were successfully processed.
243: .SH FILES
244: .MW \*(dQ/postprint.ps
245: .br
246: .MW \*(dQ/forms.ps
247: .br
248: .MW \*(dQ/ps.requests
249: .SH SEE ALSO
250: .BR dpost (1),
251: .BR postdaisy(1),
252: .BR postdmd(1),
253: .BR postio(1),
254: .BR postmd(1),
255: .BR postreverse(1),
256: .BR posttek(1),
257: .BR psencoding (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.