ENSCRIPT(1)ENSCRIPT(1)NAMEenscript - convert text files to POSTSCRIPT format for printing
SYNOPSISenscript [ -1BcGghlmoqRr2 ] [ -vcolumns ] [ -Llines ] [ -ffont ] [
-Fhfont ] [ -bheader ] [ -pout ] [ -ssize ] [ -Sfeature=value ] [
-Tcharacters ] [ spoolopts ] [ files ]
DESCRIPTIONenscript reads in plain text files, converts them to POSTSCRIPT format,
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 POSTSCRIPT
(e.g., Times-Roman, Times-BoldItalic Helvetica, Courier), and a point
size (1 point=1/72 inch - 8 point is a good small font). 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 your default body font to 8 point
Times Roman.
The possible options are:
-1 set in 1 column. One column is the default.
-2 set in 2 columns.
-vcolumns
output is set in columns number of columns. This is an
extension of the -2 switch.
-r rotate the output 90 degrees (landscape mode). This is good for
output 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 print in gaudy mode: causes page headings, dates, page numbers
to be printed in a flashy style, at some slight performance
expense.
-l simulate a line printer: make pages 66 lines long and omit
headers.
-B omit page headings.
-c Truncate ("cut") lines that are longer than the page width.
Normally, 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.
-Llines
set the maximum number of lines to output on a page. Enscript
usually computes how many to put on a page based on point size,
and may put fewer per page than requested by lines.
-ffont sets the font to be used for the body of each page. Defaults to
Courier10, unless two column rotated mode is used, in which case
it defaults to Courier7.
-Fhfont
sets the font to be used for page headings. Defaults to
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 POSTSCRIPT 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 non-printing
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 suppress printing of 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 keyword in the PostScript Printer Description file.
For example, "enscript -S ManualFeed" turns on manual feed.
-T characters
sets the width of a tab to be "characters" number of characters.
This is especially useful when printing with a variable width
font, to get columns to line up correctly.
In 4.3bsd systems, the following spooler options are also recognized:
-P printer
causes the output to be sent to the named printer.
-# 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.
-J name
sets the job name for use on the burst page. Otherwise, the
name of the first input file will be used.
-C class
set the job classification for use on the burst page.
In System V, the following spooler options are also recognized:
-t title
sets job title for use on the burst page.
-d dest
causes the output to be sent to the named printer or printer
class, unless file is specified; in which case, the printer name
is used to access the printer's PPD file for information, and
the output is written to the specified file instead of being
spooled for printing.
-n n 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/lib/transcript
for enscript prologue and font metric files.
PSTEMPDIR
path name of temporary directory to use instead of /tmp for
spooled temporary files.
PRINTER (4.3bsd)
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/lib/transcript/*.afm
font metrics files.
/usr/lib/transcript/enscript.pro
prologue for enscript files.
SEE ALSOpr(1), transcript(1), psfonts(1), ps630(1).
4.3bsd: lpr(1), lpq(1), lprm(1).
System V: lp(1), cancel(1), lpstat(1).
DIAGNOSTICS
Should be self explanatory.
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 trademark of Adobe Systems Incorporated.
Times and Helvetica are registered trademarks of Linotype.
Adobe Systems 27 February 1991 ENSCRIPT(1)