aboutsummaryrefslogtreecommitdiff
path: root/man/man1/tr2post.1
diff options
context:
space:
mode:
authorrsc <devnull@localhost>2005-01-03 06:40:20 +0000
committerrsc <devnull@localhost>2005-01-03 06:40:20 +0000
commit058b0118a52061ad57694c01fc8763b22b789c4d (patch)
tree6685f04dea5ed68edaa34998c976aed34c55fe94 /man/man1/tr2post.1
parent2600337aa704efbeba8201e88147a764b4fd2b90 (diff)
downloadplan9port-058b0118a52061ad57694c01fc8763b22b789c4d.tar.gz
plan9port-058b0118a52061ad57694c01fc8763b22b789c4d.tar.bz2
plan9port-058b0118a52061ad57694c01fc8763b22b789c4d.zip
Some man pages.
Diffstat (limited to 'man/man1/tr2post.1')
-rw-r--r--man/man1/tr2post.1111
1 files changed, 111 insertions, 0 deletions
diff --git a/man/man1/tr2post.1 b/man/man1/tr2post.1
new file mode 100644
index 00000000..3c4597f3
--- /dev/null
+++ b/man/man1/tr2post.1
@@ -0,0 +1,111 @@
+.TH TR2POST 1
+.SH NAME
+tr2post \- convert troff intermediate to PostScript
+.SH SYNOPSIS
+.B tr2post
+[
+.B options
+]
+[
+.I files ...
+]
+.SH DESCRIPTION
+.I Tr2post
+converts
+.I files
+(or standard input),
+which should be the device-independent output of
+.IR troff (1),
+into the PostScript printer language.
+.PP
+The options are:
+.TP
+.BI -a " aspectratio
+Set an aspect ratio
+.RI ( y / x )
+to stretch the PostScript output (default 1.0).
+.TP
+.BI -c " copies
+Set a comment in the PostScript output
+marking the number of copies that should be printed.
+The comment is intended for ancient versions of the Unix
+\fIlp\fR(1) and is not recognized by any current printer
+or print spooler.
+.TP
+.BI -d
+Emit volumes of debugging output on standard error.
+.TP
+.BI -m " magnification
+Magnify the PostScript output (default 1.0).
+.TP
+.BI -n " formsperpage
+Print the PostScript with
+.I formsperpage
+logical pages per physical page
+(default 1).
+Using this option emits PostScript with invalid document structuring
+comments.
+It will print fine but will not view correctly in
+.IR gv (1)
+or
+.IR psv (1).
+.TP
+.BI -o " pagelist
+Print only the pages in the
+.IR pagelist ,
+which is a comma-separated list of ranges.
+Each range is of the form
+.I p
+(just page
+.IR p ),
+.IB p - q
+(pages
+.I p
+through
+.IR q ),
+.BI - p
+(pages 1 through
+.IR p ),
+or
+.IB p -
+(pages
+.I p
+through the end of the document).
+.TP
+.BI -p " " l
+Print the document in landscape mode.
+An argument that does not begin with
+.L l
+will print the document in portrait mode.
+.TP
+.BI -x " xoffset
+Translate the page output by
+.I xoffset
+inches to the right.
+(Negative offsets translate to the left.)
+.TP
+.BI -y " yoffset
+Translate the page output by
+.I yoffset
+inches down.
+(Negative offsets translate up.)
+.TP
+.BI -P " pscode
+Emit the text
+.I pscode
+at the end of the usual PostScript header.
+.PD
+.SH EXAMPLE
+Preview this manual page:
+.IP
+.EX
+troff -man /usr/local/plan9/man/man1/tr2post.1 |
+tr2post |
+psfonts >/tmp/a.ps
+psv /tmp/a.ps
+.EE
+.SH SOURCE
+.B /usr/local/plan9/src/cmd/postscript/tr2post
+.SH SEE ALSO
+.IR troff (1),
+.IR psfonts (1)