NAME

enscript − convert text files to POSTSCRIPT format for printing

SYNOPSIS

enscript [ options ] [ spooler options ] [ files ]

DESCRIPTION

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

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:

% setenv ENSCRIPT −fTimes-Roman8

sets your default body font to 8 point Times Roman. 

The possible options are:

−2 set in two columns. 

−1 set in one column (the default). 

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

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

−k enables page prefeed (if the printer supports it).  This allows simple documents (e.g., program listings in one font) to print somewhat faster by keeping the printer running between pages. 

−K disable page prefeed (the default). 

−h suppress printing of job burst page. 

The following spooler options are also recognized:

−ttitle
sets job title for use on the burst page.

−ddest
causes the output to be sent to the named printer or printer class.

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

EXAMPLES

enscript −daleph 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. 

ENVIRONMENT

ENSCRIPTstring of options to be used by enscript. 

PSLIBDIRpath name of a directory to use instead of /usr/lib/ps for enscript prologue and font metric files. 

PSTEMPDIRpath name of temporary directory to use instead of /usr/tmp for spooled temporary files. 

LPDESTthe name of a printer (as in the −d option) for lp to use.  If no −d option is specified, lp(1) will use this printer.  If neither −d nor LPDEST is set, enscript will spool to a printer class named “PostScript”. 

FILES

/usr/lib/ps/∗.afmfont metrics files. 
/usr/lib/ps/enscript.proprologue for enscript files. 

SEE ALSO

cancel(1), getopt(3C), lp(1), lpstat(1), pr(1). 

DIAGNOSTICS

Should be self explanatory. 

AUTHOR

Adobe Systems Incorporated
Gaudy mode by Guy Riddle of AT&T Bell Laboratories

FEATURES

Options and the ENSCRIPT environment string are parsed in getopt(3C) fashion.

BUGS

Long lines are truncated.  Line truncation may be off by a little bit as printer margins vary.  There should be a "wrap" option and multiple (truncated or wrapped) columns. 

There are too many options. 

NOTES

POSTSCRIPT is a trademark of Adobe Systems Incorporated. 
Times and Helvetica are registered trademarks of Allied Corporation.

Version 3.6  —  December 20, 1987