up | Inhaltsverzeichniss | Kommentar

Manual page for PSROFF(1)

psroff - ditroff to a POSTSCRIPT printer

SYNOPSIS

psroff [ -t ] [ troff options ] [ spool options ] [ files ]

DESCRIPTION

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

transcript(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.


index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97