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 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