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 .IR 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 \fIlp\fR(1) and is not recognized by any current printer
33 or print spooler.
34 .TP
35 .BI -d
36 Emit volumes of debugging output on standard error.
37 .TP
38 .BI -m " magnification
39 Magnify the PostScript output (default 1.0).
40 .TP
41 .BI -n " formsperpage
42 Print the PostScript with
43 .I formsperpage
44 logical pages per physical page
45 (default 1).
46 Using this option emits PostScript with invalid document structuring
47 comments.
48 It will print fine but will not view correctly in
49 .IR gv (1)
50 or
51 .I psv
52 (see
53 .IR page (1)).
54 .TP
55 .BI -o " pagelist
56 Print only the pages in the
57 .IR pagelist ,
58 which is a comma-separated list of ranges.
59 Each range is of the form
60 .I p
61 (just page
62 .IR p ),
63 .IB p - q
64 (pages
65 .I p
66 through
67 .IR q ),
68 .BI - p
69 (pages 1 through
70 .IR p ),
71 or
72 .IB p -
73 (pages
74 .I p
75 through the end of the document).
76 .TP
77 .BI -p " " l
78 Print the document in landscape mode.
79 An argument that does not begin with
80 .L l
81 will print the document in portrait mode.
82 .TP
83 .BI -x " xoffset
84 Translate the page output by
85 .I xoffset
86 inches to the right.
87 (Negative offsets translate to the left.)
88 .TP
89 .BI -y " yoffset
90 Translate the page output by
91 .I yoffset
92 inches down.
93 (Negative offsets translate up.)
94 .TP
95 .BI -P " pscode
96 Emit the text
97 .I pscode
98 at the end of the usual PostScript header.
99 .PD
100 .SH EXAMPLE
101 Preview this manual page:
102 .IP
103 .EX
104 troff -man \*9/man/man1/tr2post.1 |
105 tr2post |
106 psfonts >/tmp/a.ps
107 psv /tmp/a.ps
108 .EE
109 .SH SOURCE
110 .B \*9/src/cmd/postscript/tr2post
111 .SH SEE ALSO
112 .IR troff (1),
113 .IR psfonts (1)