Commands Reference, Volume 4

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
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)	(none)

Flags

-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

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

Files

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

Related Information

The col command, enscript command, eqn command, lp command, managefonts command, nroff command, pic command, psdit command, refer command, tbl command, troff command.