psroff(1) psroff(1)NAME psroff - formats a file through troff so it can be printed on a POSTSCRIPT printer SYNOPSIS psroff [-t] [[-a] [-i] [-mname] [-nN] [-olist] [-q] [-raN] [-sN] [-Tdest]] [[-ddest] [-C class] [-J name] [-h] [-nx] [-P printer] [-r] [-s] [-m] [-w]] [file]... ARGUMENTS -a Sends a printable ASCII approximation of the results to the standard output. This is a troff option. -C class Sets the job classification for use on the burst page. -ddest Causes the output to be sent to the named destination. file Specifies the file to be processed through troff. If this argument is not specified, the standard input is used. -h Suppresses the printing of the job burst page. -i Reads standard input after the input files are exhausted. This is a troff option. -J name Sets the job name for use on the burst page. -m Sends mail after files have been printed. -mname Inserts the /usr/lib/tmac/tmac.name macro file at the beginning of the input files. This is a troff option. -nN Numbers the first generated page N. This is a troff option. -nx Causes x copies of the output to be produced. The default is one. -olist Prints only pages whose page numbers appear in the comma-separated list of numbers and ranges. A range N-M means pages N through M; an initial -N means from the beginning to page N; and a final N- means from N to the end. (See LIMITATIONS, later in this section.) This is a troff option. -Pprinter January 1992 1
psroff(1) psroff(1)Sends the output to the named printer. -q Invokes the simultaneous input-output mode of the .rd request. This is a troff option. -r Does not page-reverse the output when used with the lp spooler. Removes the file upon completion of spooling or upon completion of printing, when used with the lpr spooler. -raN Sets register a (one character name) to N. This is a troff option. -s Suppresses messages from lp, when used with the lp spooler. Uses symbolic links instead of copying files to the spool directory, when used with the lpr spooler. -sN Generates output to encourage typesetter to stop every N pages, produce a trailer to allow changing cassettes, and resume when the typesetter's start button is pressed. This is a troff option. -t Sends the POSTSCRIPT output to the standard output rather than spooling it to a printer. Note that this overrides the meaning of the troff -t option; if that option is needed, then run troff directly. -Tdest Prepares output for device dest, which may be a laser printer or a typesetter. For POSTSCRIPT output destined for an Apple LaserWriter, use -Tpsc, and pipe the output to the POSTSCRIPT filter psdit. The supported typesetter is the Autologic APS-5 (-Taps). For output destined for an Apple ImageWriter II printer, use the -Tiw option and pipe the output to daiw(1). Other output devices may be available. This is a troff option. -w Writes to the user's terminal after files have been printed. DESCRIPTION psroff is a shell script that runs troff(1) in an environment to produce output on a POSTSCRIPT printer. It uses psdit to convert troff intermediate output to POSTSCRIPT format and spools this output for printing. By default, the print spooler used by psroff is the Berkeley spooler, lpr(1), which uses these options: -C class, -J name, -P printer, -r, and -s. 2 January 1992
psroff(1) psroff(1)The environment variable SPOOLER may be set to specify the System V spooler, lp(1), which uses these options: -ddest, -nx, -h, -r, -s, -m, and -w. All other options are passed to troff. Using psroff is equivalent to using the pipeline of commands: troff -Tpsc options | psdit | $SPOOLER options Using psroff instead of this pipeline involves less typing, but the entire sequence may take slightly more time since a shell script will be executed. Environment variables The following environmental variables may be used in conjunction with psroff: SPOOLER The name of the print spooler, lpr or lp, for psroff to use. If SPOOLER is not set, psroff spools to lpr. PRINTER The name of a printer (as in the -P option) for lpr to use. If no -P option is specified, lpr uses this printer. If neither -P nor PRINTER is set, psroff spools to a printer named PostScript. This environment variable has no effect on the spooler lp. LPDEST The name of a printer (as in the -d option) for lp to use. If no -d option is specified, lp uses this printer. If neither -d nor LPDEST is set, psroff spools to a printer class named PostScript. This environment variable has no effect on the spooler lpr. LIMITATIONS The eqn supplied with troff is different from the original. Use the options -r576 -m2 for best results. Other programs (for example, pic) distributed with troff have the device names compiled in (so much for device independence!). Use -T576 with the pic distributed with the Documenter'sr rWorkbench . If your output is destined for an ApplerImageWriter II printer, use the -Tiw option for both picand eqn. FILES /usr/bin/psroff Executable file /usr/lib/tmac/tmac.* Standard macro files January 1992 3
psroff(1) psroff(1)/usr/lib/font/devpsc/* troff description files for POSTSCRIPT virtual device SEE ALSO daiw(1), eqn(1), lpr(1), lp(1), pic(1), psdit(1), refer(1), tbl(1), troff(1). ``nroff/troff Reference'' in A/UX Text Processing Tools 4 January 1992