MAN page from RedHat Other enscript-1.6.1-1.i386.rpm

ENSCRIPT

Section: ENSCRIPT (1)
Updated: Jun 25, 1998
Index

 

NAME

enscript - convert text files to PostScript

 

SYNOPSIS

enscript[-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 baselineskip][-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 generatedPostScript output to the specified printer or leaves it to file. Ifno input files are given, enscript processes standard input.Enscript can be extended to handle different output media and ithas 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 canbe 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 ishandy 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 isconstructed from file's name and last modification time.

The header string header can contain the same formatting escapeswhich can be specified for the %Format directives in the userdefined fancy headers. For example, the following option prints thefile name, current data and page numbers:

enscript --header='$n %W Page $% of $=' *.c

The header string can also contain left, center and right justifiedfields which are separated with the '|' character:

enscript --header='$n|%W|Page $% of $=' *.c

now the file name is printed left justified, the date is centered tothe header and the page numbers are printed right justified.

-B, --no-header

Do not print page headers.

-c, --truncate-lines

Cut lines that are too long. As a default, enscript wraps longlines so no information is lost.

See also option --slice which can be used to slice long linesto separate pages.

-C[start_line], --line-numbers[=start_line]

Precede each line with its line number. Optional argumentstart_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 output. Ifno value is given, key key is removed from definitions.

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 arestandardized. See section PAGE DEVICE OPTIONS for details.

-e[char], --escapes[=char]

Enable special escapes interpretation (see section SPECIALESCAPES). If argument char is given, it changes the escapecharacter to char. The default escape character is 0.

-E[lang], --pretty-print[=lang]

Pretty-print source code by creating a special input filter with thestates program. Optional argument lang specifies thelanguage to highlight, as a default states makes an educatedguess.

A description of supported highlighting languages and file formats canbe printed with command:

enscript --help-pretty-print

The highlighting rules are defined in the`/usr/share/enscript/enscript.st' file which can be edited tocreate highlighting definitions for new languages.

Note! You can't use your own input filters with thisoption.

-f name, --font=name

Select font that is used for body text. The default body font isCourier10, unless multicolumn landscape printing mode isselected, in which case the default is Courier7.

Font specification name contains two parts: font's name andfont'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 areseparated by a `@' character. This allows enscript to usefonts which contain digit characters in their names.

The font point size can also be given in formatwidth/height where width and height specifythe 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 forcompatibility since enscript prints binary files anyway.

-G, --fancy-header[=name]

Print fancy page header name to top of each page. Option-G specifies the default fancy header (see sectionCONFIGURATION FILES to see how the default fancy header can bechanged).

-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 notgiven, the default value 2 is used. As a default, no highlight barsare printed.

-i num, --indent=num

Indent every line num characters. The indentation can also bespecified in other units by appending an unit specifier after thenumber. 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 filtercan be a single command or a command pipeline and it can refer to thename of the input file with escape `%s'. The name of the input filestdin can be changed with option `--filter-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 mustwrite 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 completed.

-M name, --media=name

Select output media name. Enscript's default outputmedia 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 outputto stdout.

-P name, --printer=name

Spool output to the printer name.

-q, --quiet, --silent

Make enscript really quiet. Only fatal error messages areprinted 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 canbe given as a decimal number. When enscript moves from line toline, 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 output. Ifno value is given, key key is removed from definitions.

Statusdict operators are implementation dependant; see printer'sdocumentation 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 nameof 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 bechanged 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 usedto remove underlay that was specified with the `Underlay'configuration 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 forlang 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 supportsfollowing 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 modifications.This allows that enscript can be used as a lp filter.

PostScript files are recognized by looking up the `%!' magic cookiefrom the beginning of the file. Note! Enscript recognizedalso the Windoze damaged `^D%!' cookie.

PCL files are recognized by looking up the `^[E' or `^[%' magiccookies from the beginning of the file.

--color[=color]

Set the pretty-printing color model to color. If no coloris specified, use color model emacs.

--download-font=fontname

Include the font description file (.pfa or .pfb file) ofthe font fontname to the generated output.

--filter-stdin=name

Specify how stdin is shown to the input filter. The defaultvalue is an empty string ("") but some programs require thatstdin is called something else, usually "-".

--h-column-height=height

Set the horizontal column height to be height PostScriptpoints. The option sets the formfeed type tohorizontal-columns.

--help

Print short help message and exit.

--help-pretty-print

Describe all supported --pretty-print languages and fileformats.

--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, topand bottom PostScript points. Any of arguments can be leftempty in which case the default value is used.

--mark-wrapped-lines[=style]

Mark wrapped lines in the output with style style. Possiblevalues 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 forformat 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 numPostScript points. The default is 10 points.

--nup-ypad=num

Set the page y-padding of the n-up printing to numPostScript points. The default is 10 points.

--page-label-format=format

Set page label format to format. Page label format specifieshow 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 itsoutput, to level. The possible values are 1, and2.

--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 inputfiles, new slice starts from the point where the line would otherwisebe 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 isTimes-Roman200.

--ul-gray=num

Print underlay text with gray value num (0 ... 1), the defaultgray is .8.

--ul-position=position_spec

Set underlay text's starting position according toposition_spec. Position specification must be given in format:`sign xpos sign ypos', where sign mustbe `+' or `-'. Positive dimensions are measured from the lower leftcorner and negative dimensions from the upper right corner. Forexample, 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 forstyle are:

outline

print outline underlay texts (default)

filled

print filled underlay texts

 

CONFIGURATION FILES

Enscriptreads configuration information from following sources (in thisorder): command line options, environment variable ENSCRIPT,user's personal configuration file ($HOME/.enscriptrc), siteconfiguration file (/usr/etc/enscriptsite.cfg) and system'sglobal configuration file (/usr/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 acceptedas printable or should they be considered as non-existent. Thedefault 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 endof 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 127to the backslash-octal notation (default). Value false (0) generates8-bit PostScript code leaving all characters untouched.

DefaultEncoding: name

Select the default input encoding. Encoding name name can beone 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 withoutan 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. Possiblevalues 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 thegenerated output.

EscapeChar: num

Specify the escape character for special escapes. The default valueis 0.

FormFeedType: type

Specify what to do when a formfeed character is encountered from theinput. 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 tothe 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 0so no highlight bars are printed.

LibraryPath: path

Specifies enscript's library path that is used to lookupvarious resources. Default path is:`/usr/share/enscript:home/.enscript'. Where home isthe user's home directory.

MarkWrappedLines: style

Mark wraped lines in the output with style style. Possiblevalues 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 physicaldimensions are width and height. Media's bounding box isspecified by points (llx, lly) and (urx, ury).Enscriptprints 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. Thisoption 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 forformat 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 valueis PS-Adobe-3.0. Since some printers do not like DSC levelsgreater than 2.0, this option can be used to change the output firstline to something more suitable like %!PS-Adobe-2.0 or%!.

PageLabelFormat: format

Set page label format to format. Possible values forformat 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 itsoutput, to level. The possible values for level are thesame 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 inlpr -Pps. This option can also be used to pass other flags tothe spooler command but they must be given before the queue switch.

SetPageDevice: key[:value]

Pass a page device definition to the generated PostScript output.

Spooler: name

Names printer spooler command. Enscript pipes generatedPostScript to command name.

StatesColorModel: model

Set the pretty-printing color model to model. Possible valuesare blackwhite and emacs.

StatesConfigFile: file

Read pretty-printer states configuration from file file. Thedefault config file is `/usr/share/enscript/enscript.st'.

StatesHighlightLevel: level

Set the pretty-printing highlight level to level. Possiblevalues are none, light and heavy.

StatesPath: path

Define path for the states program.

StatusDict: key[:value]

Pass a statusdict definition to the generated PostScript output.

TOCFormat: format

Format table of contents entries with format string format.Format string format can contain the same escapes which are usedto format header strings with the `%Format' special comment.

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

UnderlayStyle: style

Set underlay text's style to style.

 

CUSTOMIZATION

Users can create their own fancy headers by creating a headerdescription file and placing it in a directory which is inenscript's library path. The name of the header file must be informat: `headername.hdr'. Header can be selected by givingoption: --fancy-header=headername.

Header description file contains PostScript code that paints theheader. Description file must provide procedure do_header whichis called by enscript at the beginning of every page.

Header description file contains two parts: comments and code. Partsare separated by a line containing text:

% -- code follows this line --

Enscriptcopies only the code part of description file to the generatedPostScript output. The comments part can contain any data, it is notcopied. If separator line is missing, no data is copied to output.

Enscriptdefines following constants which can be used in header descriptionfiles:

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 theuser supplied header string.

user_header_center_str

if user_header_p is true, this is the center field of theuser supplied header string

user_header_right_str

if user_header_p is true, this is the right field of theuser 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 yourheaders and to specify some extra options. Special comments are likeDSC comments but they start with a single `%' character; specialcomments start from the beginning of the line and they have thefollowing syntax:

%commentname: options

Currently enscript support the following special comments:

%Format: name format

Define a new string constant name according to the format stringformat. Format string start from the first non-space characterand it ends to the end of the line. Format string can contain general`%' escapes and input file related `$' escapes. Currently followingescapes 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 inputfile'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 thetoc 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 ofContents' format: if the --toc option is given, escape expandsto `num-'; if the --toc is not given, escape expands toan 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 theescape is printed. For example, escape "$5%" will expand to somethinglike " 12". If the width is negative, the value will be printedleft-justified.

For example, the `emacs.hdr' defines its date string with thefollowing format comment:

%Format: eurdatestr %E

which expands to:

/eurdatestr (96/01/08) def

%HeaderHeight: height

Allocate height points space for the page header. The defaultheader height is 36 points.

%FooterHeight: height

Allocate height points space for the page footer. The defaultfooter height is 0 points.

According to Adobe's Document Structuring Conventions (DSC), allresources needed by a document must be listed in document's prolog.Since user's can create their own headers, enscript don't knowwhat resources those headers use. That's why all headers must containa 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 standardcontinuation comment:

%%+ font fontname3

 

SPECIAL ESCAPES

Enscript supports special escape sequences which can be used toadd some page formatting commands to ASCII documents. As a default,special escapes interpretation is off, so all ASCII files print out aseveryone expects. Special escapes interpretation is activated bygiving option -e, --escapes to enscript.

All special escapes start with the escape character. The defaultescape character is ^@ (octal 000); escape character can be changedwith option -e, --escapes. Escape character isfollowed 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 defaultvalue 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 givenas a decimal 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 andvalues enclosed with brackets and filename is the name of theEPS file.

If filename ends to the `|' character, then filename isassumed to name a command that prints EPS data to its standard output.In this case, enscript opens a pipe to the specified commandand 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 thatposition 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 fromcurrent point x coordinate (relative position)

xnuma

set image's top left x coordinate to column num (absoluteposition)

ynum

move image's top left y coordinate num lines from currentline (relative position)

ynuma

set image's top left y coordinate to line num (absoluteposition)

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) andcharacters (horizontal). You can also specify other units byappending an unit specifier after number. Possible unit specifiersand 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 byfollowing 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 fontspecification default can be used to select the default bodyfont (enscript's default or the one specified by the commandline 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 defaultvalue is 1.0 (white) which disables highlighting.

 

PAGE DEVICE OPTIONS

Page device is a PostScript level 2 feature that offers an uniforminterface to control printer's output device. Enscriptprotects all page device options inside an if block so they have noeffect in level 1 interpreters. Although all level 2 interpreterssupport page device, they do not have to support all page deviceoptions. For example some printers can print in duplex mode and somecan not. Refer to the documentation of your printer for supportedoptions.

Here are some usable page device options which can be selected withthe -D, --setpagedevice option. For a complete listing,see PostScript Language Reference Manual: section 4.11 DeviceSetup.

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 thedefault configuration. If default actions have been changed from theconfiguration 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 filefoo.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 (landscape).

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 defaultoptions for enscript. For example, to select the default bodyfont to be Times-Roman 7pt, set the following value to theENSCRIPT environment variable:

-fTimes-Roman7

The value of the ENSCRIPT variable is processed before thecommand line options, so command line options can be used to overwritethese defaults.

Variable ENSCRIPT_LIBRARY specifies the enscript'slibrary directory. It can be used to overwrite the build-in default`/usr/share/enscript'.

 

RETURN VALUE

Enscript returns value 1 to the shell if any errors wereencountered. On successfull termination, the return code isconstucted from the following 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

/usr/share/enscript/*.hdr               header files/usr/share/enscript/*.enc               input encoding vectors/usr/share/enscript/enscript.pro        PostScript prolog/usr/share/enscript/*.afm               AFM files for PostScript fonts/usr/share/enscript/font.map            index for the AFM files/usr/share/enscript/enscript.st         states definition file/usr/etc/enscript.cfg                   system-wide configuration file/usr/etc/enscriptsite.cfg               site configuration file~/.enscriptrc                           personal configuration file~/.enscript/                            personal resource directory

 

SEE ALSO

diffpp(1), ghostview(1), gs(1), lpq(1), lpr(1), lprm(1), states(1)

 

AUTHOR

Markku Rossi <http://www.iki.fi/~mtr/>

GNU Enscript WWW home page: <http://www.iki.fi/~mtr/genscript/>

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

CONFIGURATION FILES

CUSTOMIZATION

SPECIAL ESCAPES

PAGE DEVICE OPTIONS

PRINTING EXAMPLES

ENVIRONMENT VARIABLES

RETURN VALUE

FILES

SEE ALSO

AUTHOR

---

This document was created byman2html,using the manual pages.