psroff Command

Purpose

Converts files from troff format to PostScript format.

Syntax

psroff [ -t ] [ -dQueue ] [ -nNumber ] [ -tTitle ] [ -DFontDirectory ] [ -FFontFamily ] [ -PFlag ] [ troffFlags ] [ File ... ]

Description

The psroff command is a shell script that runs the troff command in an environment to produce output on a PostScript printer. It uses the psdit command to convert troff intermediate output to PostScript format, and spools this output for printing. If no files are specified, the standard input is used.

To include arbitrary PostScript language commands or files in a troff document, see the psdit command.

PostScript Font Information

The PostScript Fonts for Transcript table shows the fonts available for the TranScript commands. The fonts are available by long name when using the enscript command, and by short name when using the psroff or troff commands. The following table shows the psroff commands (short names) used to declare a default set of fonts. The alphabetic characters are case-sensitive:

PostScript Fonts for Transcript
Long Name (Short Name) Font Family
AvantGarde-Book (ag) AvantGarde
AvantGarde-Demi (Ag) AvantGarde
AvantGarde-DemiOblique (AG) AvantGarde
AvantGarde-BookOblique (aG) AvantGarde
Bookman-Demi (Bo) Bookman
Bookman-DemiItalic (BO) Bookman
Bookman-Light (bo) Bookman
Bookman-LightItalic (bO) Bookman
Courier (C) Courier
Courier-Bold (CB) Courier
Courier-BoldOblique (CO) Courier
Courier-Oblique (CO) Courier
Garamond-Bold (Ga) Garamond
Garamond-BoldItalic (GA) Garamond
Garamond-Light (ga) Garamond
Garamond-LightItalic (gA) Garamond
Helvetica (H) Helvetica
Helvetica-Bold (HB) Helvetica
Helvetica-Oblique (HO) Helvetica
Helvetica-BoldOblique (HD) Helvetica
Helvetica-Narrow (hn) Helvetica
Helvetica-Narrow-Bold (Hn) Helvetica
Helvetica-Narrow-BoldOblique (HN) Helvetica
Helvetica-Narrow-Oblique (hN) Helvetica
LubalinGraph-Book (lu) Lubalin
LubalinGraph-BookOblique (lU) Lubalin
LubalinGraph-Demi (Lu) Lubalin
LubalinGraph-DemiOblique (LU) Lubalin
Item Description
NewCenturySchlbk (NC) NewCentury
NewCenturySchlbk-Bold (Nc) NewCentury
NewCenturySchlbk-Italic (nC) NewCentury
NewCenturySchlbk-Roman (nc) NewCentury
Optima (op) Optima
Optima-Bold (Op) Optima
Optima-BoldOblique (OP) Optima
Optima-Oblique (oP) Optima
Palatino-Bold (PB) Palatino
Palatino-BoldItalic (PX) Palatino
Palatino-Italic (PI) Palatino
Palatino-Roman (PA) Palatino
Souvenir-Demi (Sv) Souvenir
Souvenir-DemiItalic (SV) Souvenir
Souvenir-Light (sv) Souvenir
Souvenir-LightItalic (sV) Souvenir
Times-Bold (TB) Times
Times-BoldItalic (TD) Times
Times-Italic (TI) Times
Times-Roman (TR) Times
Symbol (S) (none)
ZapfChancery-MediumItalic (ZC) Zapf
ZapfDingbats (none)

Flags

Item Description
-DFontDirectory Finds font family directories in the specified font directory, rather than the standard font directory, which was configured in the installation procedure. It may be necessary to use both this flag and the -F flag to imitate the -F flag in the troff command.
-dQueue Causes the output to be queued to the queue specified by the Queue parameter. If the -d flag is not used, the psroff command queues output on the default queue, the first queue known to the qdaemon. This flag is recognized by the spooler print.
-FFontFamily Uses the specified font family for the R/I/B/BI fonts, rather than the Times default family. The Times, Courier, and Helvetica font families are defined at your site, and others are available as well. Ensure that the printer you use contains the font family you pick. This flag overrides the troff command -F flag. If you want to use the troff command -F flag, you should run the troff command directly or use the -D flag instead.
-nNumber Causes the number of output copies specified by the Number parameter to be produced. The default is one. This flag is recognized by the spooler print.
-PFlag Passes the Flag parameter to the spooler. This flag is useful when a conflict exists between a spooler flag and a flag with the psroff command.
-t Sends the PostScript output to the standard output, rather than spooling it to a printer. This flag overrides the troff command -t flag. If you want the troff command -t flag, you should run the troff command directly.
-tTitle Sets the job name for use on the first banner page. The default is to use the name of the first input file. This flag is recognized by the spooler print.

Parameters

Item Description
troffFlags Specifies standard flags available with the troff command.
File Specifies the troff intermediate output file. The default is the standard input.

Files

Item Description
/usr/share/lib/tmac/tmac.* Contains the standard macro files.
/usr/lib/font/devpsc/* Contains the troff description files for PostScript virtual device.
/usr/lib/ps/*.afm Contains Adobe Font Metrics (AFM) files for use with the enscript command.
/usr/lib/ps/font.map Contains the list of font names with their abbreviations.
/usr/lib/ps/ditroff.font Contains font family files for the troff command.