PSROFF(1)PSROFF(1)NAMEpsroff - ditroff to a POSTSCRIPT printer
SYNOPSISpsroff [ -t ] [ troff options ] [ spool options ] [ files ]
DESCRIPTIONpsroff is a shell script that runs [di]troff(1) in an environment to
produce output on a POSTSCRIPT printer. It uses psdit to convert
ditroff intermediate output to POSTSCRIPT format, and spools this for
printing. If no files are specified, the standard input is used.
For those interested in including arbitrary POSTSCRIPT language
commands or files in a ditroff document, see psdit(1).
In addition to the standard ditroff options, the following options are
understood by psroff.
-t sends the POSTSCRIPT output to the standard output, rather than
spooling it to a printer. Note that this overrides the meaning
of the ditroff -t option; if you want that, run ditroff
directly.
-F fontfamily
use the specified font family for the R/I/B/BI fonts, rather
than the default family, which is Times. Fontfamilies 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 -F option; if you want that, run
ditroff directly, or use the -D option.
-D fontdirectory
find font family directories in the specified 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 -F option to imitate the -F option
in ditroff.
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, psroff 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, psroff will spool to a printer class named
``PostScript''.
FILES
/usr/lib/tmac/tmac.* standard macro files
/usr/lib/transcript/ditroff.font/devpsc/*
ditroff description files for POSTSCRIPT virtual
device.
SEE ALSOtranscript(1), psdit(1), ptroff(1), psfonts(1).
[di]troff(1), eqn(1), tbl(1), pic(1), refer(1), ideal(1).
4.2bsd: lpr(1).
System V: lp(1).
J. F. Ossanna, Nroff/Troff user's manual
B. W. Kernighan, A TROFF Tutorial and A Typesetter-independent TROFF
Documenter's Workbench
AUTHOR
Adobe Systems Incorporated
BUGS
The eqn supplied with ditroff is different than the original. Use the
options -r576-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 -T option and read the
device description file for the information they need. Use -T576 with
the pic distributed with DWB.
NOTES
POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.
Documenter's Workbench is a trademark of AT&T Technologies.
Adobe Systems 14 July 1987 PSROFF(1)