PTROFF(1)PTROFF(1)NAMEptroff - troff to a POSTSCRIPT printer
SYNOPSISptroff [ -t ] [ -lpaperlength ] [ -ssize ] [ -Ffamily ] [ troff options
] [ spool options ] [ files ]
DESCRIPTIONptroff is a shell script that runs [o]troff(1) in an environment to
produce output on a POSTSCRIPT printer. It uses pscat to convert troff
C/A/T output to a POSTSCRIPT print file, and spools this for printing.
If no files are specified, the standard input is used.
Page offset distances and the page length are specified by giving a
fixed-point real number optionally followed by a units measure. For
example, 1in means one inch, 15mm means fifteen millimeters. If no
units are indicated, points (72 to the inch) are used.
In addition to the standard [o]troff options, the following options are
understood by ptroff.
-t sends the POSTSCRIPT output to the standard output, rather than
spooling it to a printer. Note that this overrides the meaning
of the troff -t option; if you want the C/A/T file, run [o]troff
directly.
-l pagelength
specifies the page length to use when splitting the C/A/T file
into POSTSCRIPT pages. The default is 11in. Units are
described above.
-s size
chooses a paper size for printing, such as Letter, Legal, or A4.
-F fontfamily
names a font family to load into [o]troff and pscat. Fontfamily
is used to name both a *.head file containing troff ``fp''
commands, and a *.ct file containing a character mapping for
pscat. Fontfamilies ``Times'' and ``Helvetica'' are probably
defined at your site, others may be available.
In 4.2bsd UNIX systems, the following spooler options are passed on to
lpr.
-Pprinter
causes the output to be sent to the named printer.
-#n causes n copies of the output to be produced. The default is
one.
-h suppress the printing of the job burst page.
-C class
set the job classification for use on the burst page.
-J name
set the job name for use on the burst page. Otherwise, the name
of the first input file will be used.
-m send mail after files have been printed.
In System V UNIX systems, the following spooler options are passed on
to lp.
-ddest causes the output to be sent to the named destination.
-nn causes n copies of the output to be produced. The default is
one.
-h suppress the printing of the job burst page.
-r don't page-reverse the output.
-s suppress messages from lp.
-m send mail after files have been printed.
-w write to user's terminal after files have been printed.
ENVIRONMENT
PRINTER (4.2bsd)
the name of a printer (as in the -P option) for lpr to use. If
no -P option is specified, lpr will use this printer. If
neither -P nor PRINTER is set, ptroff will spool to a printer
named ``PostScript''.
LPDEST (System V)
the name of a printer (as in the -d option) for lp to use. If
no -d option is specified, lp will use this printer. If neither
-d nor LPDEST is set, ptroff will spool to a printer class named
``PostScript''.
FILES
XTROFFFONTDIRX/*.ct character correspondence tables for pscat.
XTROFFFONTDIRX/*.head troff headers containing ``.fp'' commands.
XTROFFFONTDIRX/ftXX font width files for troff.
XPSLIBDIRX/pscat.pro default POSTSCRIPT prologue for pscat.
SEE ALSOpscat(1), pscatmap(8).
4.2bsd: troff(1).
System V: otroff(1).
J. F. Ossanna, Nroff/Troff user's manual
Documenter's Workbench
AUTHOR
Adobe Systems Incorporated
BUGS
Because of the character mapping tables used, explicit use of the
``.fp'' troff directive will usually produce the wrong result. Users
must build and reference correct tables with pscatmap(8) for non-
standard ``.fp'' combinations to work.
More flexibility is allowed by using troff, pscat, and the spooler
separately.
NOTES
POSTSCRIPT is a trademark of Adobe Systems Incorporated.
Times and Helvetica are registered trademark of Allied Corporation.
Documenter's Workbench is a trademark of AT&T Technologies.
Adobe Systems 12 Nov 1985 PTROFF(1)