.TH PTROFF 1 "12 Nov 1985" "Adobe Systems" \" RCSID: $Header: ptroff.1p,v 2.1 85/11/24 12:40:12 shore Rel $ .ds PS P\s-2OST\s+2S\s-2CRIPT\s+2 .SH NAME ptroff \- troff to a P\s-2OST\s+2S\s-2CRIPT\s+2 printer .SH SYNOPSIS .B ptroff [ .B \-t ] [ .BI \-F family ] [ .I "troff options" ] [ .I "spool options" ] [ .I files ] .SH DESCRIPTION .I ptroff is a shell script that runs .RI [ o ] troff (1) in an environment to produce output on a \*(PS printer. It uses .I pscat to convert .I troff C/A/T output to a \*(PS print file, and spools this for printing. If no .I files are specified, the standard input is used. .PP In addition to the standard .RI [ o ] troff options, the following options are understood by .I ptroff. .TP .B \-t sends the \*(PS output to the standard output, rather than spooling it to a printer. Note that this overrides the meaning of the .I troff .B \-t option; if you want the C/A/T file, run .RI [ o ] troff directly. .TP .BI \-F " fontfamily" names a font family to load into .RI [ o ] troff and .IR pscat. .I Fontfamily is used to name both a .I *\.head file containing .I troff ``fp'' commands, and a .I *\.ct file containing a character mapping for .IR pscat . Fontfamilies ``Times'' and ``Helvetica'' are probably defined at your site, others may be available. .PP In 4.2bsd UNIX systems, the following spooler options are passed on to .IR lpr . .TP .BI \-P printer causes the output to be sent to the named printer. .TP .BI \-# n causes .I n copies of the output to be produced. The default is one. .TP .B \-h suppress the printing of the job burst page. .TP .BI \-C " class" set the job classification for use on the burst page. .TP .BI \-J " name" set the job name for use on the burst page. Otherwise, the name of the first input file will be used. .TP .BI \-m send mail after files have been printed. .PP In System V UNIX systems, the following spooler options are passed on to .IR lp . .TP .BI \-d dest causes the output to be sent to the named destination. .TP .BI \-n n causes .I n copies of the output to be produced. The default is one. .TP .B \-h suppress the printing of the job burst page. .TP .B \-r don't page-reverse the output. .TP .BI \-s suppress messages from .IR lp . .TP .BI \-m send mail after files have been printed. .TP .BI \-w write to user's terminal after files have been printed. .SH ENVIRONMENT .IP "PRINTER (4.2bsd)" the name of a printer (as in the .B \-P option) for .I lpr to use. If no .B \-P option is specified, .I lpr will use this printer. If neither .B \-P nor PRINTER is set, .I ptroff will spool to a printer named ``PostScript''. .IP "LPDEST (System V)" the name of a printer (as in the .B \-d option) for .I lp to use. If no .B \-d option is specified, .I lp will use this printer. If neither .B \-d nor LPDEST is set, .I ptroff will spool to a printer class named ``PostScript''. .SH "FILES" .TP 2.2i /usr/misc/lib/ps/troff.font/*.ct character correspondence tables for .IR pscat . .TP /usr/misc/lib/ps/troff.font/*.head .I troff headers containing ``.fp'' commands. .TP /usr/misc/lib/ps/troff.font/ftXX font width files for .IR troff . .TP /usr/misc/lib/ps/pscat.pro default \*(PS prologue for .IR pscat . .SH "SEE ALSO" pscat(1), pscatmap(8). .br 4.2bsd: troff(1). .br System V: otroff(1). .br J. F. Ossanna, .I Nroff/Troff user's manual .br .I Documenter's Workbench .SH AUTHOR Adobe Systems Incorporated .SH 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 .IR catmap (8) for non-standard ``.fp'' combinations to work. .PP More flexibility is allowed by using .IR troff , .IR pscat , and the spooler separately. .SH NOTES \*(PS is a trademark of Adobe Systems Incorporated. .br Times and Helvetica are registered trademark of Allied Corporation. .br Documenter's Workbench is a trademark of AT&T Technologies.