source: trunk/third/transcript/man/ptroff.1p @ 9217

.TH PTROFF 1 "19 August 1992" "Adobe Systems"
\" RCSID: $Header: /afs/dev.mit.edu/source/repository/third/transcript/man/ptroff.1p,v 1.2 1996-10-14 05:09:50 ghudson Exp $
\" ATTN GOVERNMENT END USERS: See notice of rights in file XPSLIBDIRX/Notice
\" RCSID: $Header: /afs/dev.mit.edu/source/repository/third/transcript/man/ptroff.1p,v 1.2 1996-10-14 05:09:50 ghudson Exp $
.ds PS P\s-2OST\s+2S\s-2CRIPT\s+2
.SH NAME
ptroff \- troff to a PostScript 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 
[o]troff(1)
in an environment to produce output on a \*(PS printer.  It uses 
pscat
to convert 
troff
C/A/T output to a \*(PS language print file, and spools this for printing.
If no 
.I files
are specified, the standard input is used.
.PP
In addition to the standard
[o]troff
options, the following options are understood by 
.I ptroff.
.TP
.B -t
sends the \*(PS language output to the standard output,
rather than spooling it to a printer.
Note that this overrides the meaning of the 
troff
.B -t 
option; if you want the C/A/T file, run 
[o]troff
directly.
.TP
.BI -F fontfamily
names a font family to load into 
[o]troff
and
pscat.
.I Fontfamily 
is used to name both a 
*\.head
file containing 
troff
"fp" commands, and a 
*\.ct 
file containing a character mapping for 
pscat.
Font families "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
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
suppresses the printing of the job burst page.
.TP
.BI -C class
sets the job classification for use on the burst page.
.TP
.BI -J name
sets the job name for use on the burst page.  Otherwise, the name of the
first input file will be used.
.TP
.BI -m
sends mail after files have been printed.
.PP
In System V UNIX systems, the following spooler options are passed on to
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
suppresses the printing of the job burst page.
.TP
.B -r
don't page-reverse the output.
.TP
.BI -s
suppresses messages from 
lp.
.TP
.BI -m
sends mail after files have been printed.
.TP
.BI -w
writes to the user's terminal after files have been printed.
.SH ENVIRONMENT
.IP "PRINTER (BSD)"
the name of a printer (as in the 
.B -P
option) for 
lpr
to use.  If no 
.B -P 
option is specified,
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 n
.B -d
option) for 
lp
to use.  If no 
.B -d 
option is specified,
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
XTROFFFONTDIRX/*.ct
character correspondence tables for 
pscat.
.TP
XTROFFFONTDIRX/*.head
troff
headers containing ".fp" commands.
.TP
XTROFFFONTDIRX/ftXX 
font width files for 
troff.
.TP
XPSLIBDIRX/pscat.pro
default \*(PS language prologue for 
pscat.
.SH "SEE ALSO"
pscat(1), pscatmap(8)
.br
BSD: 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 pscatmap (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 registered trademark of Adobe Systems Incorporated.
.br
\*(TS is a trademark of Adobe Systems Incorporated.
.br 
Times and Helvetica are registered trademark of Linotype.
.br
Documenter's Workbench is a trademark of AT&T Technologies.
.br
Unix is a trademark of AT&T Bell Laboratories.