enscript(1) enscript(1)NAME enscript - converts text files to POSTSCRIPT format for printing SYNOPSIS enscript [-1] [-2] [-bheader] [-B] [-ffont] [-Fhfont] [-g] [-G] [-h] [-k] [-K] [-l] [-Llines] [-m] [-o] [-pout] [-q] [-r] [-R] [[-#n] [-Cclass] [-Jname] [-Pprinter]] [files] enscript [-1] [-2] [-bheader] [-B] [-ffont] [-Fhfont] [-g] [-G] [-h] [-k] [-K] [-l] [-Llines] [-m] [-o] [-pout] [-q] [-r] [-R] [[-ddest] [-nn] [-ttitle] [-w] [files] ARGUMENTS -#n Produces n copies. The default is one. -1 Sets the text in one column (the default). -2 Sets the text in two columns. -bheader Sets the string to be used for page headings to header. The default header is constructed from the filename, its last modification date, and a page number. -B Omits page headings. -Cclass Sets the job classification for use on the burst page. -ddest Sends the output to the named printer or printer class. -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. files Specifies the text files to be converted. -Fhfont Sets the font to be used for page headings. Defaults to Courier-Bold10. -g Enables the printing of files containing nonprinting characters. Any file with more than a small number of nonprinting characters is suspected of being garbage and is not printed unless this option is used. -G Prints in gaudy mode; causes page headings, dates, page numbers to be printed in a flashy style, at some slight January 1992 1
enscript(1) enscript(1)performance expense. -h Suppresses printing of a job burst page. -Jname Sets the job name for use on the burst page. Otherwise, the name of the first input file is used. -k Enables page prefeed (if the printer supports it). This allows simple documents (for example, program listings in one font) to print somewhat faster by keeping the printer running between pages. -K Disables page prefeed (the default). -l Simulates a line printer; makes pages 66 lines long and omit headers. -Llines Sets the maximum number of lines to output on a page. The enscript command usually computes how many to put on a page based on point size, and may put fewer per page than requested by lines. -m Sends mail via mail(1) after the files have been printed. By default, no mail is sent upon normal completion of the print request. -nn Produces n copies. The default is one. -o Lists any missing characters whenever characters cannot be found within a specified font. -pout Writes the POSTSCRIPT file to the named file rather than spooling it for printing. As a special case, -p will send the POSTSCRIPT to the standard output. -Pprinter Sends the output to the named printer. -q Suppresses the status messages. The enscript command won't report about pages, destination, omitted characters, and so forth. Fatal errors are still reported to the standard error output. -r Rotates 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 the -2 option. enscript -2r files 2 January 1992
enscript(1) enscript(1)is a nice way to get program listings. -R Does not rotate. This option is also known as portrait mode (the default). -ttitle Sets the job title for use on the burst page. -w Writes a status message to the user's terminal after files have been printed. DESCRIPTION enscript reads plain text files, converts them to POSTSCRIPT format, and spools them for printing on a POSTSCRIPT printer. Fonts, headings, and limited formatting and spooling options may be specified. By default, the print spooler used by enscript is the Berkeley spooler, lpr. The environment variable SPOOLER may be set to specify the System V spooler, lp. For example enscript -Paleph boring.txt processes the file called boring.txt for POSTSCRIPT printing, sending the output to the printer aleph. enscript -2r boring.c prints a two-up landscape listing of the file called boring.c on the default printer. Font specifications have two parts: A font name that POSTSCRIPT recognizes (for example, Times-Roman, Times-Roman BoldItalic , Helvetica, Courier), and a point size (1 point=1/72 inch). 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 -#n, -Cclass, -Jname, and -Pprinter spooler options are passed to the lpr command. The -ddest, -nn, -ttitle, and -w spooler options are passed to the lp command. January 1992 3
enscript(1) enscript(1)Environment Variables The following environmental variables may be used in conjunction with enscript: SPOOLER The name of the print spooler, lpr or lp, for enscript to use. If SPOOLER is not set, enscript will spool to lpr. ENSCRIPT String of options to be used by enscript. PSLIBDIR Pathname of a directory to use instead of /usr/lib/ps for enscript prologue and font metric files. PSTEMPDIR Pathname of temporary directory to use instead of XPSTEMDIRX of spooled temporary files. PRINTER 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''. This environment variable has no effect on the spooler lp. LPDEST The name of a printer for lp to use. If LPDEST is not set, enscript will spool to a printer class named PostScript. This environment variable has no effect on the spooler lpr. Features Options and the ENSCRIPT environment string are parsed in getopt(3) fashion. LIMITATIONS Long lines are truncated. Because printer margins vary, line truncation may be off. There should be a ``wrap'' option and multiple (truncated or wrapped) columns. NOTES POSTSCRIPT is a trademark of Adobe Systems Incorporated. Times and Helvetica are registered trademarks of Linotype. FILES /usr/bin/enscript Executable file /usr/lib/ps/*.afm Font metrics files /usr/lib/ps/enscript.pro 4 January 1992
enscript(1) enscript(1)Prologue file for enscript files SEE ALSO lp(1), lpr(1), lprm(1), lpstat(1), pr(1) getopt(3C) in A/UX Programmer's Reference January 1992 5