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

.TH PSROFF 1 "19 August 1992" "Adobe Systems"
\" Copyright (c) 1985,1987,1992 Adobe Systems Incorporated. All Rights Reserved.
\" ATTN GOVERNMENT END USERS: See notice of rights in file XPSLIBDIRX/Notice
\" RCSID: $Header: /afs/dev.mit.edu/source/repository/third/transcript/man/psroff.1p,v 1.2 1996-10-14 05:09:49 ghudson Exp $
.ds PS P\s-2OST\s+2S\s-2CRIPT\s+2
.SH NAME
psroff \- ditroff to a PostScript printer
.SH SYNOPSIS
.B psroff
[ 
.B -t
] [
.I "troff options"
] [
.I "spool options"
] [
.I files
]
.SH DESCRIPTION
.I psroff
is a shell script that runs
[di]troff(1)
in an environment to produce output on a \*(PS printer.
It uses
psdit
to convert
ditroff
intermediate output to \*(PS language format and spools this for printing.
If no 
.I files
are specified, the standard input is used.
.PP
For those interested in including arbitrary \*(PS language commands
or files in a
ditroff
document, see psdit(1).
.PP
In addition to the standard 
ditroff 
options, the following options are understood by 
.IR psroff .
.TP
.B -t 
sends the \*(PS language file to the standard output, 
rather than spooling it to a printer.
Note that this overrides the meaning of the 
ditroff
.B -t 
option; if you want that, run 
ditroff
directly.
.TP
.BI -F fontfamily
use the specified font family for the R/I/B/BI fonts, rather than the
default family, which is
Times.
Font families
Times,
Courier,
and
Helvetica
are probably defined at
your site, and others may be available as well.
Make sure the printer you will use contains the font family you pick.
Note that this overrides the meaning of the 
ditroff
.B -F 
option; if you want that, run 
ditroff
directly, or use the
.B -D
option.
.TP
.BI -D fontdirectory
finds font family directories in the specified
.I fontdirectory
rather than the standard font directory which was configured in the
installation procedure.
Note that it may be necessary to use both this option and the
.B -F
option to imitate the
.B -F
option in
ditroff.
.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
set 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
.SH ENVIRONMENT
.IP "PRINTER"
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 psroff
will spool to a printer named "PostScript".
.SH FILES
.TP 2.2i
/usr/lib/tmac/tmac.*
standard macro files
.TP
XDITDIRX/devpsc/*
ditroff description files for the \*(PS printer virtual device
.SH "SEE ALSO"
transcript(1), psdit(1), ptroff(1), psfonts(1),
[di]troff(1), eqn(1), tbl(1), pic(1), refer(1), ideal(1), lpr(1)
.br
J. F. Ossanna,
.I Nroff/Troff User's Manual
.br
B. W. Kernighan,
.I A TROFF Tutorial
and
.I A Typesetter-independent TROFF
.br
.I
Documenter's Workbench
.SH AUTHOR
Adobe Systems Incorporated
.SH BUGS
The 
eqn
supplied with 
ditroff
is different from the original.  Use the options 
.B -r576
.B -m2
for best results.  Other programs (e.g.,
pic )
distributed with 
ditroff
have the device names compiled in (so much for device independence!).
They should just have a 
.B -T
option and read the device description file for the information they need.
Use
.B -T576
with the
pic
distributed with 
DWB.
.SH NOTES
\*(PS is a registered trademark of Adobe Systems Incorporated.
.br
Documenter's Workbench is a trademark of AT&T Technologies.
.br
Unix is a trademark of AT&T Bell Laboratories.