4.3BSD-UWisc/man/catl/enscript.l
ENSCRIPT(1) UNIX Programmer's Manual ENSCRIPT(1)
NAME
enscript - convert text files to POSTSCRIPT format for
printing
SYNOPSIS
enscript [ -12BGghKklmoqRr ] [ -L_l_i_n_e_s ] [ -f_f_o_n_t ] [
-F_h_f_o_n_t ] [ -b_h_e_a_d_e_r ] [ -p_o_u_t ] [ _s_p_o_o_l_o_p_t_s ] [ _f_i_l_e_s ]
DESCRIPTION
_e_n_s_c_r_i_p_t 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 _b_e_f_o_r_e 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:
-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 pro-
gram listings when used in conjunction with -2.
"enscript -2r files" is a nice way to get program list-
ings.
-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.
Printed 1/10/87 12 Nov 1985 1
ENSCRIPT(1) UNIX Programmer's Manual ENSCRIPT(1)
-l simulate a line printer: make pages 66 lines long and
omit headers.
-B omit page headings.
-b_h_e_a_d_e_r
sets the string to be used for page headings to _h_e_a_d_e_r.
The default header is constructed from the file name,
its last modification date, and a page number.
-L_l_i_n_e_s
set the maximum number of lines to output on a page.
_E_n_s_c_r_i_p_t usually computes how many to put on a page
based on point size, and may put fewer per page than
requested by _l_i_n_e_s.
-f_f_o_n_t
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.
-F_h_f_o_n_t
sets the font to be used for page headings. Defaults
to Courier-Bold10.
-p_o_u_t
causes the POSTSCRIPT file to be written to the named
file rather than being spooled for printing. As a spe-
cial case, -p - will send the POSTSCRIPT to the stan-
dard 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 _e_n_s_c_r_i_p_t cannot find characters in a font, the miss-
ing characters are listed.
-q causes _e_n_s_c_r_i_p_t to be quiet about what it is doing.
_E_n_s_c_r_i_p_t 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.
Printed 1/10/87 12 Nov 1985 2
ENSCRIPT(1) UNIX Programmer's Manual ENSCRIPT(1)
In 4.2bsd systems, the following spooler options are also
recognized:
-P_p_r_i_n_t_e_r
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 comple-
tion.
-J_n_a_m_e
sets the job name for use on the burst page. Other-
wise, the name of the first input file will be used.
-C_c_l_a_s_s
set the job classification for use on the burst page.
In System V, the following spooler options are also recog-
nized:
-t_t_i_t_l_e
sets job title for use on the burst page.
-d_d_e_s_t
causes the output to be sent to the named printer or
printer class.
-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 _e_n_s_c_r_i_p_t.
PSLIBDIR
path name of a directory to use instead of
/usr/misc/lib/ps for enscript prologue and font metric
files.
PSTEMPDIR
path name of temporary directory to use instead of
XPSTEMDIRX of spooled temporary files.
PRINTER (4.2bsd)
the name of a printer (as in the -P option) for _l_p_r to
use. If no -P option is specified, _l_p_r will use this
Printed 1/10/87 12 Nov 1985 3
ENSCRIPT(1) UNIX Programmer's Manual ENSCRIPT(1)
printer. If neither -P nor PRINTER is set, _e_n_s_c_r_i_p_t
will spool to a printer named ``PostScript''.
LPDEST (System V)
the name of a printer (as in the -d option) for _l_p to
use. If no -d option is specified, _l_p will use this
printer. If neither -d nor LPDEST is set, _e_n_s_c_r_i_p_t
will spool to a printer class named ``PostScript''.
FILES
/usr/misc/lib/ps/*.afm
font metrics files.
/usr/misc/lib/ps/enscript.pro
prologue for enscript files.
lpr(1 bsd), lp(1 V) Printer spooler
SEE ALSO
pr(1), ps630(1), getopt(3).
4.2bsd: 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
FEATURES
Options and the ENSCRIPT environment string are parsed in
_g_e_t_o_p_t(3) 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.
_E_n_s_c_r_i_p_t generates temporary files which are spooled for
printing. The temporary file names are used by the spooling
software (e.g., _l_p_q), rather than the symbolic job name
passed to _l_p_r.
There are too many options.
NOTES
POSTSCRIPT is a trademark of Adobe Systems Incorporated.
Times and Helvetica are registered trademarks of Allied Cor-
poration.
Printed 1/10/87 12 Nov 1985 4