-# num Print num copies of each page.
|
-1, -2, -3, -4, -5, -6, -7, -8, -9, --columns=num
Specify how many columns each page have. With the long option --columns=num you can specify more
than 9 columns per page.
|
-a pages, --pages=pages
Specify which pages are printed. The page specification pages can be given in the 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 option is useful in two-side and 2-up
printings (--file-align=2).
|
-b header, --header=header
Use the text header as a page header. The default page header is constructed from the name of
the file and from its 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 date and page numbers:
|
-B, --no-header
Do not print page headers.
|
-c, --truncate-lines
Cut lines that are too long for the page. As a default, enscript wraps long lines to the next
line so no information is lost.
You can also use the --slice option which slices long lines to separate pages.
|
-C[start_line], --line-numbers[=start_line]
Precede each line with its line number. The 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 output. If no value is given, the key
key is removed from the definitions.
For example, the command
enscript -DDuplex:true foo.txt
prints file foo.txt in duplex (two side) mode.
Page device operators are implementation dependent but they are standardized. See section PAGE
DEVICE OPTIONS for the details.
|
-e[char], --escapes[=char]
Enable special escapes interpretation (see section SPECIAL ESCAPES). If the argument char is
given, it changes the escape character to char. The default escape character is 0.
|
-E[lang], --highlight[=lang]
Highlight source code by creating a special input filter with the states program. The optional
argument lang specifies the language to highlight. As a default the states makes an educated
guess.
You can print a short description of the supported highlighting languages and file formats with
the command:
enscript --help-highlight
The highlighting rules are defined in the `/usr/share/enscript/hl/*.st' files which can be edited
to create highlighting definitions for new languages.
Note! You can not use your own input filters with this option.
|
-f name, --font=name
Select a font that is used for the body text. The default body font is Courier10, unless
multicolumn landscape printing mode is selected, in which case the default font is Courier7.
The font specification name contains two parts: the name of the font and its size in PostScript
points. For example, "Times-Roman12" selects the "Times-Roman" font with size 12pt.
The font specification name can also be given in format `name@ptsize', where the name of the font
and its 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 the format width/height where the width and the height
specify the size of the font in x- and y-directions. For example, "Times-Roman@10/12" selects a
10 points wide and 12 points high "Times-Roman" font.
You can also give the font sizes as decimal numbers. For example, "Times-Roman10.2" selects a
10.2pt "Times-Roman" font.
|
-F name, --header-font=name
Select a font for the header texts.
|
-g, --print-anyway
Print a file even if it contains binary data. The option is implemented only for compatibility
purposes. Enscript prints binary files anyway regardless of the option.
|
-G, --fancy-header[=name]
Print a fancy page header name to the top of each page. The 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 the highlight bars are in lines. If the 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. The 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 an input filter filter. The input filter can be a single command or
a command pipeline. The filter can refer to the name of the input file with the escape `%s'.
The name of the standard input can be changed with the option `--filter-stdin'.
For example, the following command prints the file `foo.c' by using only upper-case characters:
|
-j, --borders
Print borders around columns.
|
-J title
An alias for the 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 the options --lines-per-page=66, and
--no-header.
|
-L num, --lines-per-page=num
Print only num lines for each page. As a default, the number of lines per page is computed from
the height of the page and from the size of the font.
|
-m, --mail
Send a mail notification to user after the print job has been completed.
|
-M name, --media=name
Select an output media name. Enscript's default output media is determined from libpaper and
falls back to A4.
|
-n num, --copies=num
Print num copies of each page.
|
-N nl, --newline=nl
Select the newline character. The possible values for nl are: n (unix newline, 0xa hex) and r
(mac newline, 0xd hex).
|
-o file An alias for the option -p, --output.
|
-O, --missing-characters
Print a listing of character codes which couldn't be printed.
|
-p file, --output=file
Leave the output to file file. If the file is `-', enscript sends the output to the standard
output stdout.
|
-P name, --printer=name
Spool the output to the printer name.
|
-q, --quiet, --silent
Make enscript really quiet. Only fatal error messages are printed to stderr.
|
-r, --landscape
Print in the landscape mode; rotate page 90 degrees.
|
-R, --portrait
Print in the portrait mode (default).
|
-s num, --baselineskip=num
Specify the baseline skip in PostScript points. The number num can be given as a decimal number.
When enscript moves from line to line, the 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. If no value is given, the key
key is removed from the definitions.
The statusdict operators are implementation dependent; see the printer's documentation for the
details.
For example, the command
enscript -Ssetpapertray:1 foo.txt
prints the file foo.txt by using paper from the paper tray 1 (assuming that the printer supports
paper tray selection).
|
-t title, --title=title
Set banner page's job title to title. The option sets also the name of the input file stdin.
|
-T num, --tabsize=num
Set the tabulator size to num characters. The default is 8.
|
-u[text], --underlay[=text]
Print the string text under every page. The properties of the text can be changed with the
options --ul-angle, --ul-font, --ul-gray, --ul-position, and --ul-style.
If no text is given, the underlay is not printed. This can be used to remove an underlay text
that was specified with the `Underlay' configuration file option.
|
-U num, --nup=num
Print num logical pages on each output page (N-up printing). The values num must be a power of
2.
|
-v, --verbose[=level]
Tell what enscript is doing.
|
-V, --version
Print enscript version information and exit.
|
-w [lang], --language[=lang]
Generate output for the language lang. The possible values for lang are:
|
-X name, --encoding=name
Use the input encoding name. Currently enscript supports the following encodings:
|
-z, --no-formfeed
Turn off the 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.
The PostScript files are recognized by looking up the `%!' magic cookie from the beginning of the
file. Note! Enscript recognized also the Windoze damaged `^D%!' cookie.
The PCL files are recognized by looking up the `^[E' or `^[%' magic cookies from the beginning of
the file.
|
--color[=bool]
Use colors in the highlighting outputs.
|
--download-font=fontname
Include the font description file (.pfa or .pfb file) of the font fontname to the generated
output.
|
--extended-return-values
Enable extended return values. As a default, enscript returns 1 on error and 0 otherwise. The
extended return values give more details about the printing operation. See the section RETURN
VALUE for the details.
|
--filter-stdin=name
Specify how the stdin is shown to the input filter. The default value is an empty string ("")
but some programs require that the stdin is called something else, usually "-".
|
--footer=footer
Use the text footer as a page footer. Otherwise the option works like the --header option
|
--h-column-height=height
Set the horizontal column height to be height PostScript points. The option sets the formfeed
type to horizontal-columns.
|
--help Print a short help message and exit.
|
--help-highlight
Describe all supported --highlight languages and file formats.
|
--highlight-bar-gray=gray
Specify the gray level which is used in printing the highlight bars.
|
--list-media
List the names of all known output media and exit successfully.
|
--mark-wrapped-lines[=style]
Mark wrapped lines in the output with the style style. The possible values for the 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 the non-printable characters are printed. The possible values for the 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-columnwise
Change the layout of the sub-pages in the N-up printing from row-wise to columnwise.
|
--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 the page label format to format. The page label format specifies how the labels for the
`%%Page:' PostScript comments are formatted. The possible values are:
short Print the current pagenumber: `%%Page: (1) 1' (default)
long Print the 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 the vertical slice num. The slices are vertical regions of input files. A new slice
starts from the point where the line would otherwise be wrapped to the next line. The slice
numbers start from 1.
|
--style=style
Set the highlighting style to style. The possible values are: a2ps, emacs, emacs_verbose, ifh,
and msvc.
|
--swap-even-page-margins
Swap left and right page margins for even-numbered pages.
|
--toc Print a table of contents to the end of the output.
|
--word-wrap
Wrap long lines from word boundaries.
|
--ul-angle=angle
Set the angle of the underlay text to angle. As a default, the angle is atan(-d_page_h,
d_page_w).
|
--ul-font=name
Select a font for the underlay text. The default underlay font is Times-Roman200.
|
--ul-gray=num
Print the underlay text with the gray value num (0 ... 1), the default gray value is .8.
|
--ul-style=style
Set the underlay text's style to style. The possible values for style are:
|