ENSCRIPT(1) ENSCRIPT ENSCRIPT(1)NAMEenscript - convert text files to PostScript
SYNOPSISenscript [-12BcgGhjkKlmOqrRvVzZ] [-# copies] [-a pages] [-A align] [-b
header] [-C[start_line]] [-d printer] [-D key[:value]] [-e[char]]
[-E[lang]] [-f font] [-F header_font] [-H[num]] [-i indent] [-I filter]
[-J title] [-L lines_per_page] [-M media] [-n copies] [-N newline] [-o
outputfile] [-o -] [-p outputfile] [-p -] [-P printer] [-s baseline‐
skip] [-S key[:value]] [-t title] [-T tabsize] [-u[text]] [-U num] [-W
language] [-X encoding] [filename ...]
DESCRIPTION
Enscript converts text files to PostScript and spools generated Post‐
Script output to the specified printer or leaves it to file. If no
input files are given, enscript processes standard input. Enscript can
be extended to handle different output media and it has many options
which can be used to customize printouts.
OPTIONS
-# num Print num copies of each page.
-1, -2, --columns=num
Specify how many columns each page have. With long option
--columns=num you can specify more than 2 columns per page.
-a pages, --pages=pages
Specify which pages are printed. Page specification pages can
be given in following formats:
begin-end
print pages from begin to end
-end print pages from 0 to end
begin- print pages from begin to end
page print page page
odd print odd pages
even print even pages
-A align, --file-align=align
Align separate input files to even align page count. This is
handy for two-side and 2-up printings (--file-align=2).
-b header, --header=header
Use text header as a page header. The default page header is
constructed from file's name and last modification time.
The header string header can contain the same formatting
escapes which can be specified for the %Format directives in
the user defined fancy headers. For example, the following
option prints the file name, current data and page numbers:
enscript --header='$n %W Page $% of $=' *.c
The header string can also contain left, center and right jus‐
tified fields which are separated with the '|' character:
enscript --header='$n|%W|Page $% of $=' *.c
now the file name is printed left justified, the date is cen‐
tered to the header and the page numbers are printed right jus‐
tified.
-B, --no-header
Do not print page headers.
-c, --truncate-lines
Cut lines that are too long. As a default, enscript wraps long
lines so no information is lost.
See also option --slice which can be used to slice long lines
to separate pages.
-C[start_line], --line-numbers[=start_line]
Precede each line with its line number. Optional argument
start_line specifies the number of the first line in the input.
The number of the first line defaults to 1.
-d name Spool output to the printer name.
-D key[:value], --setpagedevice=key[:value]
Pass a page device definition to the generated PostScript out‐
put. If no value is given, key key is removed from defini‐
tions.
For example, command
enscript -DDuplex:true foo.txt
prints file foo.txt in duplex (two side) mode.
Page device operators are implementation dependant but they are
standardized. See section PAGE DEVICE OPTIONS for details.
-e[char], --escapes[=char]
Enable special escapes interpretation (see section SPECIAL
ESCAPES). If argument char is given, it changes the escape
character to char. The default escape character is 0.
-E[lang], --pretty-print[=lang]
Pretty-print source code by creating a special input filter
with the states program. Optional argument lang specifies the
language to highlight, as a default states makes an educated
guess.
A description of supported highlighting languages and file for‐
mats can be printed with command:
enscript--help-pretty-print
The highlighting rules are defined in the `/freeware/gnu-
tools/share/enscript/enscript.st' file which can be edited to
create highlighting definitions for new languages.
Note! You can't use your own input filters with this option.
-f name, --font=name
Select font that is used for body text. The default body font
is Courier10, unless multicolumn landscape printing mode is
selected, in which case the default is Courier7.
Font specification name contains two parts: font's name and
font's size in points. For example "Times-Roman12" selects
"Times-Roman" font with size 12pt.
The font specification name can also be given in format
`name@ptsize', where font's name and point size are separated
by a `@' character. This allows enscript to use fonts which
contain digit characters in their names.
The font point size can also be given in format width/height
where width and height specify the font's size in x- and y-
directions. For example "Times-Roman@10/12" selects 10 points
wide and 12 points high "Times-Roman" font.
Note! font sizes can be given as a decimal number. For example
"Times-Roman10.2" selects 10.2pt "Times-Roman" font.
-F name, --header-font=name
Select font for header texts.
-g, --print-anyway
Print file even if it contains binary data. Option is here
only for compatibility since enscript prints binary files any‐
way.
-G, --fancy-header[=name]
Print fancy page header name to top of each page. Option -G
specifies the default fancy header (see section CONFIGURATION
FILES to see how the default fancy header can be changed).
-h, --no-job-header
Suppress printing of the job header page.
-H[num], --highlight-bars[=num]
Specify how high highlight bars are in lines. If num is not
given, the default value 2 is used. As a default, no highlight
bars are printed.
-i num, --indent=num
Indent every line num characters. The indentation can also be
specified in other units by appending an unit specifier after
the number. Possible unit specifiers and the corresponding
units are:
c centimeters
i inches
l characters (default)
p PostScript points
-I filter, --filter=filter
Read all input files through input filter filter. Input filter
can be a single command or a command pipeline and it can refer
to the name of the input file with escape `%s'. The name of
the input file stdin can be changed with option `--fil‐
ter-stdin'.
For example, the following command can be used to print file
`foo.c' by using only upper-case characters:
enscript --filter="cat %s | tr 'a-z' 'A-Z'" foo.c
And to highlight changes made to files since the last checkout:
enscript --filter="rcsdiff %s | diffpp %s" -e *.c
Note! To include string "%s" to the filter command, you must
write it as "%%s".
-j, --borders
Print borders around columns.
-J title
An alias for option -t, --title.
-k, --page-prefeed
Enable page prefeed.
-K, --no-page-prefeed
Disable page prefeed (default).
-l, --lineprinter
Emulate lineprinter. This option is a shortcut for options:
--lines-per-page=66, --no-header.
-L num, --lines-per-page=num
Print only num lines per each page.
-m, --mail
Send mail notification to user after print job has been com‐
pleted.
-M name, --media=name
Select output media name. Enscript's default output media is
A4.
-n num, --copies=num
Print num copies of each page.
-N nl, --newline=nl
Select the newline character. Possible values for nl are: n
(unix newline, 0xa hex) and r (mac newline, 0xd hex).
-o file An alias for option -p, --output.
-O, --missing-characters
Print a listing of character codes which couldn't be printed.
-p file, --output=file
Leave output to file file. If file is `-', leave output to
stdout.
-P name, --printer=name
Spool output to the printer name.
-q, --quiet, --silent
Make enscript really quiet. Only fatal error messages are
printed to stderr.
-r, --landscape
Print in landscape mode; rotate page 90 degrees.
-R, --portrait
Print in portrait mode (default).
-s num, --baselineskip=num
Specify the baseline skip in PostScript points. Number num can
be given as a decimal number. When enscript moves from line to
line, current point y coordinate is moved (font point size +
baselineskip) points down. The default baseline skip is 1.
-S key[:value], --statusdict=key[:value]
Pass a statusdict definition to the generated PostScript out‐
put. If no value is given, key key is removed from defini‐
tions.
Statusdict operators are implementation dependant; see
printer's documentation for details.
For example, command
enscript -Ssetpapertray:1 foo.txt
prints file foo.txt by using paper from the paper tray 1
(assuming that printer supports paper tray selection).
-t title, --title=title
Set banner page's job title to title. Option sets also the
name of the input file stdin.
-T num, --tabsize=num
Set tabulator size to num (default is 8).
-u[text], --underlay[=text]
Print string text under every page. Text's properties can be
changed with options --ul-angle, --ul-font, --ul-gray,
--ul-position and --ul-style.
If no text is given, no underlay is printed. This can be used
to remove underlay that was specified with the `Underlay' con‐
figuration file option.
-U num, --nup=num
Print num logical pages on each output page (N-up printing).
-v, --verbose[=level]
Tell what enscript is doing.
-V, --version
Print enscript version and exit.
-W [lang], --language[=lang]
Generate output in language lang. Possible values for lang
are:
PostScript
generate PostScript (default)
html generate HTML
overstrike
generate overstrikes (line printers, less)
rtf generate RTF (Rich Text Format)
-X name, --encoding=name
Use input encoding name. Currently enscript supports following
encodings:
88591, latin1
ISO-8859-1 (ISO Latin1) (enscript's default encoding).
88592, latin2
ISO-8859-2 (ISO Latin2)
88593, latin3
ISO-8859-3 (ISO Latin3)
88594, latin4
ISO-8859-4 (ISO Latin4)
88595, cyrillic
ISO-8859-5 (ISO Cyrillic)
88597, greek
ISO-8859-7 (ISO Greek)
ascii 7-bit ascii
asciifise, asciifi, asciise
7-bit ascii with some scandinavian (fi, se) extensions
asciidkno, asciidk, asciino
7-bit ascii with some scandinavian (dk, no) extensions
ibmpc, pc, dos
IBM PC charset
mac Mac charset
vms VMS multinational charset
hp8 HP Roman-8 charset
koi8 Adobe Standard Cyrillic Font KOI8 charset
ps, PS PostScript font's default encoding
pslatin1, ISOLatin1Encoding
PostScript interpreter's `ISOLatin1Encoding'
-z, --no-formfeed
Turn off form feed character interpretation.
-Z, --pass-through
Pass through all PostScript and PCL files without any modifica‐
tions. This allows that enscript can be used as a lp filter.
PostScript files are recognized by looking up the `%!' magic
cookie from the beginning of the file. Note! Enscript recog‐
nized also the Windoze damaged `^D%!' cookie.
PCL files are recognized by looking up the `^[E' or `^[%' magic
cookies from the beginning of the file.
--color[=color]
Set the pretty-printing color model to color. If no color is
specified, use color model emacs.
--download-font=fontname
Include the font description file (.pfa or .pfb file) of the
font fontname to the generated output.
--filter-stdin=name
Specify how stdin is shown to the input filter. The default
value is an empty string ("") but some programs require that
stdin is called something else, usually "-".
--h-column-height=height
Set the horizontal column height to be height PostScript
points. The option sets the formfeed type to horizontal-col‐
umns.
--help Print short help message and exit.
--help-pretty-print
Describe all supported --pretty-print languages and file for‐
mats.
--highlight-bar-gray=gray
Specify the gray level which is used to print highlight bars.
--list-media
List the names of all known output media and exit successfully.
--list-options
List all options and their current values. Exit successfully.
--margins=left:right:top:bottom
Adjust page marginals to be exact left, right, top and bottom
PostScript points. Any of arguments can be left empty in which
case the default value is used.
--mark-wrapped-lines[=style]
Mark wrapped lines in the output with style style. Possible
values for style are:
none do not mark them (default)
plus print a plus (+) character to the end of each wrapped
line
box print a black box to the end of each wrapped line
arrow print a small arrow to the end of each wrapped line
--non-printable-format=format
Specify how non-printable characters are printed. Possible
values for format are:
caret caret notation: `^@', `^A', `^B', ...
octal octal notation: `\000', `\001', `\002', ... (default)
questionmark
replace non-printable characters with a question mark
`?'
space replace non-printable characters with a space ` '
--nup-xpad=num
Set the page x-padding of the n-up printing to num PostScript
points. The default is 10 points.
--nup-ypad=num
Set the page y-padding of the n-up printing to num PostScript
points. The default is 10 points.
--page-label-format=format
Set page label format to format. Page label format specifies
how labels for the `%%Page:' PostScript comments are formatted.
Possible values are:
short Print current pagenumber: `%%Page: (1) 1' (default)
long Print current filename and pagenumber: `%%Page:
(main.c: 1) 1'
--ps-level=level
Set the PostScript language level, that enscript uses for its
output, to level. The possible values are 1, and 2.
--printer-options=options
Pass extra options to the printer command.
--rotate-even-pages
Rotate each even-numbered page 180 degrees.
--slice=num
Print vertical slice num. Slices are vertical regions of input
files, new slice starts from the point where the line would
otherwise be wrapped to the next line. Slice numbers start
from 1.
--toc Print table of contents to the end of the print job.
--word-wrap
Wrap long lines from word boundaries.
--ul-angle=angle
Set underlay text's angle. As a default, angle is
atan(-page_height, page_width).
--ul-font=name
Select font for the underlay text. The default underlay font
is Times-Roman200.
--ul-gray=num
Print underlay text with gray value num (0 ... 1), the default
gray is .8.
--ul-position=position_spec
Set underlay text's starting position according to posi‐
tion_spec. Position specification must be given in format:
`sign xpos sign ypos', where sign must be `+' or `-'. Positive
dimensions are measured from the lower left corner and negative
dimensions from the upper right corner. For example, spec
`+0-0' specifies the upper left corner and `-0+0' specifies the
lower right corner.
--ul-style=style
Set underlay text's style to style. Possible values for style
are:
outline print outline underlay texts (default)
filled print filled underlay texts
CONFIGURATION FILES
Enscript reads configuration information from following sources (in
this order): command line options, environment variable ENSCRIPT,
user's personal configuration file ($HOME/.enscriptrc), site configura‐
tion file (/freeware/gnu-tools/etc/enscriptsite.cfg) and system's
global configuration file (/freeware/gnu-tools/etc/enscript.cfg).
The configuration files have the following format:
Empty lines and lines starting with `#' are comments.
All other lines are option lines and have format:
OPTION [arguments ...].
Following options can be specified:
AcceptCompositeCharacters: bool
Specify whatever PostScript font's composite characters are
accepted as printable or should they be considered as non-exis‐
tent. The default value is false (0).
AFMPath: path
Specifies search path for the AFM files.
AppendCtrlD: bool
Specify if the Control-D (^D) character should be appended to
the end of the output. The default value is false (0).
Clean7Bit: bool
Specify how characters greater than 127 are printed. Value
true (1) generates 7-bit clean code by escaping all characters
greater than 127 to the backslash-octal notation (default).
Value false (0) generates 8-bit PostScript code leaving all
characters untouched.
DefaultEncoding: name
Select the default input encoding. Encoding name name can be
one of the values of the -X, --encoding option.
DefaultFancyHeader: name
Select the default fancy header. Default header is used when
option -G is specified or option --fancy-header is given with‐
out an argument. System-wide default is `enscript'.
DefaultMedia: name
Select the default output media.
DefaultOutputMethod: method
Select the default target to which generated output is send.
Possible values for method are:
printer send output to printer (default)
stdout send output to stdout
DownloadFont: fontname
Include the font description file of the font fontname to the
generated output.
EscapeChar: num
Specify the escape character for special escapes. The default
value is 0.
FormFeedType: type
Specify what to do when a formfeed character is encountered
from the input. Possible values for type are:
column move to the beginning of the next column (default)
page move to the beginning of the next page
GeneratePageSize: bool
Specify whether the PageSize page device setting is generated
to the PostScript output. The default value is true (1).
HighlightBarGray: gray
Specify the gray level which is used to print highlight bars.
HighlightBars: num
Specify how high highlight bars are in lines. The default
value is 0 so no highlight bars are printed.
LibraryPath: path
Specifies enscript's library path that is used to lookup vari‐
ous resources. Default path is: `/freeware/gnu-
tools/share/enscript:home/.enscript'. Where home is the user's
home directory.
MarkWrappedLines: style
Mark wraped lines in the output with style style. Possible
values for format are the same which can be given for the
--mark-wrapped-lines option.
Media: name width height llx lly urx ury
Add a new output media with name name. Media's physical dimen‐
sions are width and height. Media's bounding box is specified
by points (llx, lly) and (urx, ury). Enscript prints all
graphics inside media's bounding box.
User can select this media by giving option -M name.
NoJobHeaderSwitch: switch
Specify the spooler option to suppress the print job header.
This option is passed to the printer spooler when enscript's
option -h, --no-job-header is selected.
NonPrintableFormat: format
Specify how non-printable characters are printed. Possible
values for format are the same which can be given for the
--non-printable-format option.
OutputFirstLine: line
Set PostScript output's first line to line, the default value
is PS-Adobe-3.0. Since some printers do not like DSC levels
greater than 2.0, this option can be used to change the output
first line to something more suitable like %!PS-Adobe-2.0 or
%!.
PageLabelFormat: format
Set page label format to format. Possible values for format
are the same which can be given for the --page-label-format
option.
PagePrefeed: bool
Enable / disable page prefeed. The default is false (0).
PostScriptLevel: level
Set the PostScript language level, that enscript uses for its
output, to level. The possible values for level are the same
which can be given for the --ps-level option.
Printer: name
Names the printer to spool to.
QueueParam: name
The spooler command switch for the printer queue, e.g. -P in
lpr -Pps. This option can also be used to pass other flags to
the spooler command but they must be given before the queue
switch.
SetPageDevice: key[:value]
Pass a page device definition to the generated PostScript out‐
put.
Spooler: name
Names printer spooler command. Enscript pipes generated Post‐
Script to command name.
StatesColorModel: model
Set the pretty-printing color model to model. Possible values
are blackwhite and emacs.
StatesConfigFile: file
Read pretty-printer states configuration from file file. The
default config file is `/freeware/gnu-
tools/share/enscript/enscript.st'.
StatesHighlightLevel: level
Set the pretty-printing highlight level to level. Possible
values are none, light and heavy.
StatesPath: path
Define path for the states program.
StatusDict: key[:value]
Pass a statusdict definition to the generated PostScript out‐
put.
TOCFormat: format
Format table of contents entries with format string format.
Format string format can contain the same escapes which are
used to format header strings with the `%Format' special com‐
ment.
Underlay: text
Print string text under every page.
UnderlayAngle: num
Set underlay text's angle to num.
UnderlayFont: fontspec
Select font for the underlay text.
UnderlayGray: num
Print underlay text with gray value num.
UnderlayPosition: position_spec
Set underlay text's starting position according to posi‐
tion_spec.
UnderlayStyle: style
Set underlay text's style to style.
CUSTOMIZATION
Users can create their own fancy headers by creating a header descrip‐
tion file and placing it in a directory which is in enscript's library
path. The name of the header file must be in format: `headername.hdr'.
Header can be selected by giving option: --fancy-header=headername.
Header description file contains PostScript code that paints the
header. Description file must provide procedure do_header which is
called by enscript at the beginning of every page.
Header description file contains two parts: comments and code. Parts
are separated by a line containing text:
% -- code follows this line --
Enscript copies only the code part of description file to the generated
PostScript output. The comments part can contain any data, it is not
copied. If separator line is missing, no data is copied to output.
Enscript defines following constants which can be used in header
description files:
d_page_w page width
d_page_h page height
d_header_x header lower left x coordinate
d_header_y header lower left y coordinate
d_header_w header width
d_header_h header height
d_footer_x footer lower left x coordinate
d_footer_y footer lower left y coordinate
d_footer_w footer width
d_footer_h footer height
d_output_w width of the text output area
d_output_h height of the text output area
user_header_p predicate which tells if user has defined his/her own
header string: true/false
user_header_left_str
if user_header_p is true, this is the left field of the
user supplied header string.
user_header_center_str
if user_header_p is true, this is the center field of
the user supplied header string
user_header_right_str
if user_header_p is true, this is the right field of
the user supplied header string
HF standard header font (from -F, --header-font option).
This can be selected simply by invoking command: `HF
setfont'.
pagenum the number of the current page
fname the full name of the printed file (/foo/bar.c)
fdir the directory part of the file name (/foo)
ftail file name without the directory part (bar.c)
gs_languagelevel
PostScript interpreter's language level (currently 1 or
2)
You can also use the following special comments to customize your head‐
ers and to specify some extra options. Special comments are like DSC
comments but they start with a single `%' character; special comments
start from the beginning of the line and they have the following syn‐
tax:
%commentname: options
Currently enscript support the following special comments:
%Format: name format
Define a new string constant name according to the format
string format. Format string start from the first non-space
character and it ends to the end of the line. Format string
can contain general `%' escapes and input file related `$'
escapes. Currently following escapes are supported:
%% character `%'
$$ character `$'
$% current page number
$= number of pages in the current file
$(VAR) value of the environment variable VAR.
%c trailing component of the current working directory
%C ($C) current time (file modification time) in `hh:mm:ss'
format
%d current working directory
%D ($D) current date (file modification date) in `yy-mm-dd'
format
%D{string} ($D{string})
format string string with the strftime(3) function.
`%D{}' refers to the current date and `$D{}' to the
input file's last modification date.
%E ($E) current date (file modification date) in `yy/mm/dd'
format
%F ($F) current date (file modification date) in `dd.mm.yyyy'
format
%H document title
$L number of lines in the current input file. This is
valid only for the toc entries, it can't be used in
header strings.
%m the hostname up to the first `.' character
%M the full hostname
%n the user login name
$n input file name without the directory part
%N the user's pw_gecos field up to the first `,' character
$N the full input file name
%t ($t) current time (file modification time) in 12-hour am/pm
format
%T ($T) current time (file modification time) in 24-hour format
`hh:mm'
%* ($*) current time (file modification time) in 24-hour format
with seconds `hh:mm:ss'
$v the sequence number of the current input file
$V the sequence number of the current input file in the
`Table of Contents' format: if the --toc option is
given, escape expands to `num-'; if the --toc is not
given, escape expands to an empty string.
%W ($W) current date (file modification date) in `mm/dd/yy'
format
All format directives except `$=' can also be given in format
escape width directive
where width specifies the width of the column to which the
escape is printed. For example, escape "$5%" will expand to
something like " 12". If the width is negative, the value will
be printed left-justified.
For example, the `emacs.hdr' defines its date string with the
following format comment:
%Format: eurdatestr %E
which expands to:
/eurdatestr (96/01/08) def
%HeaderHeight: height
Allocate height points space for the page header. The default
header height is 36 points.
%FooterHeight: height
Allocate height points space for the page footer. The default
footer height is 0 points.
According to Adobe's Document Structuring Conventions (DSC), all
resources needed by a document must be listed in document's prolog.
Since user's can create their own headers, enscript don't know what
resources those headers use. That's why all headers must contain a
standard DSC comment that lists all needed resources. For example,
used fonts can be listed with following comment:
%%DocumentNeededResources: font fontname1 fontname2
Comment can be continued to the next line with the standard continua‐
tion comment:
%%+ font fontname3
SPECIAL ESCAPES
Enscript supports special escape sequences which can be used to add
some page formatting commands to ASCII documents. As a default, spe‐
cial escapes interpretation is off, so all ASCII files print out as
everyone expects. Special escapes interpretation is activated by giv‐
ing option -e, --escapes to enscript.
All special escapes start with the escape character. The default
escape character is ^@ (octal 000); escape character can be changed
with option -e, --escapes. Escape character is followed by escape's
name and optional options and arguments.
Currently enscript supports following escapes:
bggray change the text background color. Escape's syntax is:
^@bggray{gray}
where gray is the new text background gray value. The default
value is 1.0 (white).
color change the text color. Escape's syntax is:
^@color{red green blue}
where color components red, green and blue are given as a deci‐
mal numbers between 0 and 1.
comment comment the rest of the line including the newline character.
Escape's syntax is:
^@comment text newline_character
escape change the escape character. Escape's syntax is
^@escape{code}
where code is the decimal code of the new escape character.
epsf inline EPS file to the document. Escape's syntax is:
^@epsf[options]{filename}
where options is an optional sequence of option characters and
values enclosed with brackets and filename is the name of the
EPS file.
If filename ends to the `|' character, then filename is assumed
to name a command that prints EPS data to its standard output.
In this case, enscript opens a pipe to the specified command
and reads EPS data from pipe.
Following options can be given for the epsf escape:
c print image centered
r print image right justified
n do not update current point. Following output is
printed to that position where the current point was
just before the epsf escape
nx do not update current point x coordinate
ny do not update current point y coordinate
xnum move image's top left x coordinate num characters from
current point x coordinate (relative position)
xnuma set image's top left x coordinate to column num (abso‐
lute position)
ynum move image's top left y coordinate num lines from cur‐
rent line (relative position)
ynuma set image's top left y coordinate to line num (absolute
position)
hnum set image's height to num lines
snum scale image with factor num
sxnum scale image in x direction with factor num
synum scale image in y direction with factor num
As a default, all dimensions are given in lines (vertical) and
characters (horizontal). You can also specify other units by
appending an unit specifier after number. Possible unit speci‐
fiers and the corresponding units are:
c centimeters
i inches
l lines or characters (default)
p PostScript points
For example to print an image one inch high, you can specify
height by following options: h1i (1 inch), h2.54c (2.54 cm),
h72p (72 points).
font select current font. Escape's syntax is:
^@font{fontname}
where fontname is a standard font specification. Special font
specification default can be used to select the default body
font (enscript's default or the one specified by the command
line option -f, --font).
ps include raw PostScript code to the output. Escape's syntax is:
^@ps{code}
shade highlight regions of text by changing the text background
color. Escape's syntax is:
^@shade{gray}
where gray is the new text background gray value. The default
value is 1.0 (white) which disables highlighting.
PAGE DEVICE OPTIONS
Page device is a PostScript level 2 feature that offers an uniform
interface to control printer's output device. Enscript protects all
page device options inside an if block so they have no effect in level
1 interpreters. Although all level 2 interpreters support page device,
they do not have to support all page device options. For example some
printers can print in duplex mode and some can not. Refer to the docu‐
mentation of your printer for supported options.
Here are some usable page device options which can be selected with the
-D, --setpagedevice option. For a complete listing, see PostScript
Language Reference Manual: section 4.11 Device Setup.
Collate boolean
how output is organized when printing multiple copies
Duplex boolean
duplex (two side) printing
ManualFeed boolean
manual feed paper tray
OutputFaceUp boolean
print output `face up' or `face down'
Tumble boolean
how opposite sides are positioned in duplex printing
PRINTING EXAMPLES
Following printing examples assume that enscript uses the default con‐
figuration. If default actions have been changed from the configura‐
tion files, some examples will behave differently.
enscript foo.txt
Print file foo.txt to the default printer.
enscript-Possu foo.txt
Print file foo.txt to printer ossu.
enscript-pfoo.ps foo.txt
Print file foo.txt, but leave PostScript output to file foo.ps.
enscript-2 foo.txt
Print file foo.txt to two columns.
enscript-2r foo.txt
Print file to two columns and rotate output 90 degrees (land‐
scape).
enscript -DDuplex:true foo.txt
Print file in duplex (two side) mode (printer dependant).
enscript-G2rE -U2 foo.c
My default code printing command: gaudy header, two columns,
landscape, code highlighting, 2-up printing.
enscript-E --color -Whtml --toc -pfoo.html *.h *.c
A nice HTML report of your project's C source files.
ENVIRONMENT VARIABLES
The environment variable ENSCRIPT can be used to pass default options
for enscript. For example, to select the default body font to be
Times-Roman 7pt, set the following value to the ENSCRIPT environment
variable:
-fTimes-Roman7
The value of the ENSCRIPT variable is processed before the command line
options, so command line options can be used to overwrite these
defaults.
Variable ENSCRIPT_LIBRARY specifies the enscript's library directory.
It can be used to overwrite the build-in default `/freeware/gnu-
tools/share/enscript'.
RETURN VALUE
Enscript returns value 1 to the shell if any errors were encountered.
On successfull termination, the return code is constucted from the fol‐
lowing flags:
0 no errors or warnings
2 some lines were truncated or wrapped
4 some characters were missing from the used fonts
8 some characters were unprintable
FILES
/freeware/gnu-tools/share/enscript/*.hdrheader files
/freeware/gnu-tools/share/enscript/*.encinput encoding vectors
/freeware/gnu-tools/share/enscript/enscript.proPostScript prolog
/freeware/gnu-tools/share/enscript/*.afmAFM files for PostScript fonts
/freeware/gnu-tools/share/enscript/font.mapindex for the AFM files
/freeware/gnu-tools/share/enscript/enscript.ststates definition file
/freeware/gnu-tools/etc/enscript.cfg system-wide configuration file
/freeware/gnu-tools/etc/enscriptsite.cfgsite configuration file
~/.enscriptrc personal configuration file
~/.enscript/ personal resource directory
SEE ALSOdiffpp(1), ghostview(1), gs(1), lpq(1), lpr(1), lprm(1), states(1)AUTHOR
Markku Rossi <mtr@iki.fi> <http://www.iki.fi/~mtr/>
GNU Enscript WWW home page: <http://www.iki.fi/~mtr/genscript/>
ENSCRIPT Jun 25, 1998 ENSCRIPT(1)