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