enscript man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

ENSCRIPT(1)			   ENSCRIPT			   ENSCRIPT(1)

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 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 ALSO
       diffpp(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)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net