ENSCRIPT(1) ENSCRIPT(1)
NAME
enscript-convert text files to POSTSCRIPT language format for printing
SYNOPSIS
enscript [ -1BcGghlmoqRr2 ] [ -vcolumns ] [ -Llines ] [ -fbfont ] [ -Fhfont
] [ -bheader ] [ -pout ]
[ -ssize ] [ -Sfeature=value ] [ -Tcharacters ] [ spoolopts ] [ files ]
DESCRIPTION
enscript reads in plain text files, converts them to POSTSCRIPT language,
and spools them for printing on a POSTSCRIPT printer. Fonts, headings,
limited formatting options, and spooling options may be specified.
For example:
enscript -Paleph boring.txt
prints a copy of the file called boring.txt on the printer called aleph.
enscript -2r boring.c
prints a two-up landscape listing of the file called boring.c on the
default printer (see below).
Font specifications have two parts: a font name as known to the POSTSCRIPT
printer (e.g., Times-Roman, Times-BoldItalic, Helvetica, Courier), and a
point size (1 point=1/72 inch; 8 point is a good small point size). So
Courier-Bold8 is 8 point Courier Bold, Helvetica12 is 12 point Helvetica.
The environment variable ENSCRIPT may be used to specify defaults. The
value of ENSCRIPT is parsed as a string of arguments before the arguments
that appear on the command line. For example "ENSCRIPT='-fTimes-Roman8'"
sets the default body font to 8 point Times Roman.
The possible options are:
-1 sets in 1 column. One column is the default.
-2 sets in 2 columns.
-vcolumns
output is set in columns number of columns. This is an extension of
the -2 switch.
-r rotates the output 90 degrees (landscape mode). This is good for out-
put that requires a wide page or for program listings when used in
conjunction with -2.
" enscript -2r files " is a nice way to get program listings.
-R don't rotate, also known as portrait mode (the default).
-G prints in gaudy mode: causes page headings, dates, and page numbers to
be printed in a flashy style, at some slight performance expense.
-l simulates a line printer: make pages 66 lines long and omit headers.
-B omits page headings.
-c truncates ("cuts") lines that are longer than the page width. Nor-
mally, long lines are wrapped around to the following line on the
page.
-bheader
sets the string to be used for page headings to header. The default
header is constructed from the file name, its last modification date,
and a page number. You can include elements from the default header
in your header by specifying %f for file name, %d for date, or %n for
page number. If you need a '%' character in the header, it must be
specified by "%%".
-Llines
set the maximum number of lines to output on a page. Enscript usually
computes how many lines to put on a page based on point size, and may
put fewer lines per page than requested by lines.
-fbfont
sets the font to be used for the body of each page. The default is
Courier10 unless two-column rotated mode is used, in which case the
default is Courier7.
-Fhfont
sets the font to be used for page headings. The default is Courier-
Bold10.
-pout
causes the POSTSCRIPT file to be written to the named file rather than
being spooled for printing. As a special case, -p will send the
resultingPOSTSCRIPT language code to the standard output.
-g causes the fact that a file is garbage to be ignored. Normally, any
file with more than a small number of nonprinting characters is
suspected of being garbage and not printed; this option means "print
it anyway."
-o if enscript cannot find characters in a font, the missing characters
are listed.
-q causes enscript to be quiet about what it is doing. Enscript won't
report about pages, destination, omitted characters, etc. Fatal errors
are still reported to the standard error output.
-h suppresses printing of the job burst page.
-ssize
chooses a paper size for printing. This size must match one of the
*PaperSize keywords in the POSTSCRIPT Printer Description file, such
as Letter, Legal, or A4.
-Sfeature=value
chooses a printer feature, such as manual feed or duplex. If value is
omitted, a value of true is assumed. These features must match a key-
word in the POSTSCRIPT Printer Description file. For example,
"enscript -S ManualFeed" turns on manual feed.
-Tcharacters
sets the width of a tab to be characters
number of characters. This is especially useful to get columns to
line up correctly when printing with a variable width font.
In BSD Unix systems, the following spooler options are also recognized:
-Pprinter
causes the output to be sent to the named printer unless -pfile is
specified. In that case, the printer name is used to access the
printer's POSTSCRIPT Printer Description file for information, and the
output is written to the specified file instead of being spooled for
printing.
-#n causes n copies of the output to be produced. The default is one.
-m causes the printer daemon to send mail upon job completion.
-Jname
sets the job name for use on the burst page. Otherwise, the name of
the first input file will be used.
-Cclass
set the job classification for use on the burst page.
In System V Unix systems, the following spooler options are also recog-
nized:
-ttitle
sets job title for use on the burst page.
-ddest
causes the output to be sent to the named printer or printer class
unless -pfile is specified. In that case, the printer name is used to
access the printer's POSTSCRIPT Printer Description file for informa-
tion, and the output is written to the specified file instead of being
spooled for printing.
-nn causes n copies of the output to be produced. The default is one.
-w or -m
causes the printer daemon to write or send mail upon job completion.
ENVIRONMENT
ENSCRIPT
string of options to be used by enscript
PSLIBDIR
path name of a directory to use instead of /usr/local/transcript/lib
for enscript prologue and font metric files
PSTEMPDIR
path name of a temporary directory to use instead of /usr/tmp for tem-
porary files.
PRINTER (BSD)
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, enscript 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, enscript will spool to a printer class named
"PostScript".
FILES
/usr/local/transcript/lib/*.afm
font metrics files
/usr/local/transcript/lib/enscript.pro
prologue for enscript
files
SEE ALSO
pr(1), transcript(1), psfonts(1), ps630(1)
BSD Unix systems: lpr(1), lpq(1), lprm(1)
System V Unix systems: lp(1), cancel(1), lpstat(1)
AUTHOR
Adobe Systems Incorporated
Gaudy mode by Guy Riddle of AT&T Bell Laboratories
BUGS
Enscript generates temporary files which are spooled for printing. The
temporary file names are used by the spooling software (e.g., lpq ), rather
than the symbolic job name passed to lpr .
There are too many options.
NOTES
POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.
Times and Helvetica are registered trademarks of Linotype.
Unix is a trademark of AT&T Bell Laboratories.