1 .TH TR2POST 1
2 .SH NAME
3 tr2post \- convert troff intermediate to PostScript
4 .SH SYNOPSIS
5 .B tr2post
6 [
7 .B options
8 ]
9 [
10 .I files ...
11 ]
12 .SH DESCRIPTION
13 .I Tr2post
14 converts
15 .I files
16 (or standard input),
17 which should be the device-independent output of
18 .MR troff (1) ,
19 into the PostScript printer language.
20 .PP
21 The options are:
22 .TP
23 .BI -a " aspectratio
24 Set an aspect ratio
25 .RI ( y / x )
26 to stretch the PostScript output (default 1.0).
27 .TP
28 .BI -c " copies
29 Set a comment in the PostScript output
30 marking the number of copies that should be printed.
31 The comment is intended for ancient versions of the Unix
32 .IR lp (1)
33 and is not recognized by any current printer
34 or print spooler.
35 .TP
36 .BI -d
37 Emit volumes of debugging output on standard error.
38 .TP
39 .BI -m " magnification
40 Magnify the PostScript output (default 1.0).
41 .TP
42 .BI -n " formsperpage
43 Print the PostScript with
44 .I formsperpage
45 logical pages per physical page
46 (default 1).
47 Using this option emits PostScript with invalid document structuring
48 comments.
49 It will print fine but will not view correctly in
50 .MR gv (1)
51 or
52 .I psv
53 (see
54 .MR page (1) ).
55 .TP
56 .BI -o " pagelist
57 Print only the pages in the
58 .IR pagelist ,
59 which is a comma-separated list of ranges.
60 Each range is of the form
61 .I p
62 (just page
63 .IR p ),
64 .IB p - q
65 (pages
66 .I p
67 through
68 .IR q ),
69 .BI - p
70 (pages 1 through
71 .IR p ),
72 or
73 .IB p -
74 (pages
75 .I p
76 through the end of the document).
77 .TP
78 .BI -p " " l
79 Print the document in landscape mode.
80 An argument that does not begin with
81 .L l
82 will print the document in portrait mode.
83 .TP
84 .BI -x " xoffset
85 Translate the page output by
86 .I xoffset
87 inches to the right.
88 (Negative offsets translate to the left.)
89 .TP
90 .BI -y " yoffset
91 Translate the page output by
92 .I yoffset
93 inches down.
94 (Negative offsets translate up.)
95 .TP
96 .BI -P " pscode
97 Emit the text
98 .I pscode
99 at the end of the usual PostScript header.
100 .PD
101 .SH EXAMPLE
102 Preview this manual page:
103 .IP
104 .EX
105 troff -man \*9/man/man1/tr2post.1 |
106 tr2post |
107 psfonts >/tmp/a.ps
108 psv /tmp/a.ps
109 .EE
110 .SH SOURCE
111 .B \*9/src/cmd/postscript/tr2post
112 .SH SEE ALSO
113 .MR troff (1) ,
114 .MR psfonts (1)