plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

tr2post.1 (2059B)


      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)