NAME
ptroff - troff to a POSTSCRIPT printer
SYNOPSIS
ptroff [ -t ] [ -Ffamily ] [ troff options ] [ spool options ] [ files ]
DESCRIPTION
ptroff 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.
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.
- -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
- /usr/local/lib/ps/troff.font/*.ct
- character correspondence tables for pscat.
- /usr/local/lib/ps/troff.font/*.head
- troff headers containing ``.fp'' commands.
- /usr/local/lib/ps/troff.font/ftXX
- font width files for troff.
- /usr/local/lib/ps/pscat.pro
- default POSTSCRIPT prologue for pscat.
SEE ALSO
pscat(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 catmap(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.