enscript man page on OPENSTEP

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


ENSCRIPT(1)							   ENSCRIPT(1)

NAME
       enscript - convert text files to POSTSCRIPT format for printing

SYNOPSIS
       enscript	 [  -1BcGghlmoqRr2  ]  [  -vcolumns ] [ -Llines ] [ -ffont ] [
       -Fhfont ] [ -bheader ] [ -pout ] [  -ssize  ]  [	 -Sfeature=value  ]  [
       -Tcharacters ] [ spoolopts ] [ files ]

DESCRIPTION
       enscript reads in plain text files, converts them to POSTSCRIPT format,
       and spools them for printing on a POSTSCRIPT printer.  Fonts, headings,
       limited formatting options and spooling options may be specified.

       For example:
	      enscript -Paleph boring.txt
       prints  a  copy	of  the	 file  called boring.txt on the printer called
       aleph.
	      enscript -2r boring.c
       prints a two-up landscape listing of the file called  boring.c  on  the
       default printer (see below).

       Font  specifications have two parts: A font name as known to POSTSCRIPT
       (e.g., Times-Roman, Times-BoldItalic Helvetica, Courier), and  a	 point
       size  (1	 point=1/72 inch - 8 point is a good small font).  So Courier-
       Bold8 is 8 point Courier Bold, Helvetica12 is 12 point Helvetica.

       The environment variable ENSCRIPT may be used to specify defaults.  The
       value  of  ENSCRIPT  is	parsed	as  a  string  of arguments before the
       arguments   that	  appear   on	the   command	line.	 For   example
       "ENSCRIPT='-fTimes-Roman8'"  sets  your	default	 body  font to 8 point
       Times Roman.

       The possible options are:

       -1     set in 1 column. One column is the default.

       -2     set in 2 columns.

       -vcolumns
	      output is	 set  in  columns  number  of  columns.	  This	is  an
	      extension of the -2 switch.

       -r     rotate the output 90 degrees (landscape mode).  This is good for
	      output that requires a wide page or for  program	listings  when
	      used in conjunction with -2.
	      "enscript -2r files" is a nice way to get program listings.

       -R     don't rotate, also known as portrait mode (the default).

       -G     print  in	 gaudy mode: causes page headings, dates, page numbers
	      to be printed in a flashy	 style,	 at  some  slight  performance
	      expense.

       -l     simulate	a  line	 printer:  make	 pages	66 lines long and omit
	      headers.

       -B     omit page headings.

       -c     Truncate ("cut") lines that are  longer  than  the  page	width.
	      Normally, long lines are wrapped around to the following line on
	      the page.

       -bheader
	      sets the string to be used for page  headings  to	 header.   The
	      default  header  is  constructed	from  the  file name, its last
	      modification date, and a page number.

       -Llines
	      set the maximum number of lines to output on a  page.   Enscript
	      usually  computes how many to put on a page based on point size,
	      and may put fewer per page than requested by lines.

       -ffont sets the font to be used for the body of each page.  Defaults to
	      Courier10, unless two column rotated mode is used, in which case
	      it defaults to Courier7.

       -Fhfont
	      sets the font  to	 be  used  for	page  headings.	  Defaults  to
	      Courier-Bold10.

       -pout  causes  the  POSTSCRIPT  file  to	 be  written to the named file
	      rather than being spooled for printing.  As a special case, -p -
	      will send the POSTSCRIPT to the standard output.

       -g     causes the fact that a file is garbage to be ignored.  Normally,
	      any  file	 with  more  than  a  small  number  of	  non-printing
	      characters is suspected of being garbage, and not printed - this
	      option means "print it anyway."

       -o     If enscript cannot  find	characters  in	a  font,  the  missing
	      characters are listed.

       -q     causes  enscript	to  be quiet about what it is doing.  Enscript
	      won't report about pages, destination, omitted characters,  etc.
	      Fatal errors are still reported to the standard error output.

       -h     suppress printing of job burst page.

       -ssize chooses  a paper size for printing.  This size must match one of
	      the *PaperSize keywords in the  PostScript  Printer  Description
	      file, such as Letter, Legal, or A4.

       -Sfeature=value
	      chooses  a  printer  feature, such as manual feed or duplex.  If
	      value is omitted, a value of true is  assumed.   These  features
	      must match a keyword in the PostScript Printer Description file.
	      For example, "enscript -S ManualFeed" turns on manual feed.

       -T characters
	      sets the width of a tab to be "characters" number of characters.
	      This  is	especially  useful when printing with a variable width
	      font, to get columns to line up correctly.

       In 4.3bsd systems, the following spooler options are also recognized:

       -P printer
	      causes the output to be sent to the named printer.

       -# n   causes n copies of the output to be produced.   The  default  is
	      one.

       -m     causes the printer daemon to send mail upon job completion.

       -J name
	      sets  the	 job  name  for use on the burst page.	Otherwise, the
	      name of the first input file will be used.

       -C class
	      set the job classification for use on the burst page.

       In System V, the following spooler options are also recognized:

       -t title
	      sets job title for use on the burst page.

       -d dest
	      causes the output to be sent to the  named  printer  or  printer
	      class, unless file is specified; in which case, the printer name
	      is used to access the printer's PPD file	for  information,  and
	      the  output  is  written	to the specified file instead of being
	      spooled for printing.

       -n n   causes n copies of the output to be  produced.  The  default  is
	      one.

       -w or -m
	      causes  the  printer  daemon  to	write  or  send	 mail upon job
	      completion.

ENVIRONMENT
       ENSCRIPT
	      string of options to be used by enscript.

       PSLIBDIR
	      path name of a directory to use instead  of  /usr/lib/transcript
	      for enscript prologue and font metric files.

       PSTEMPDIR
	      path  name  of  temporary	 directory  to use instead of /tmp for
	      spooled temporary files.

       PRINTER (4.3bsd)
	      the name of a printer (as in the -P option) for lpr to use.   If
	      no  -P  option  is  specified,  lpr  will	 use this printer.  If
	      neither -P nor PRINTER is set, enscript will spool to a  printer
	      named ``PostScript''.

       LPDEST (System V)
	      the  name	 of a printer (as in the -d option) for lp to use.  If
	      no -d option is specified, lp will use this printer.  If neither
	      -d  nor  LPDEST  is  set, enscript will spool to a printer class
	      named ``PostScript''.

FILES
       /usr/lib/transcript/*.afm
			     font metrics files.

       /usr/lib/transcript/enscript.pro
			     prologue for enscript files.

SEE ALSO
       pr(1), transcript(1), psfonts(1), ps630(1).
       4.3bsd: lpr(1), lpq(1), lprm(1).
       System V: lp(1), cancel(1), lpstat(1).

DIAGNOSTICS
       Should be self explanatory.

AUTHOR
       Adobe Systems Incorporated
       Gaudy mode by Guy Riddle of AT&T Bell Laboratories

BUGS
       Enscript generates temporary files which are spooled for printing.  The
       temporary  file	names  are  used by the spooling software (e.g., lpq),
       rather than the symbolic job name passed to lpr.

       There are too many options.

NOTES
       POSTSCRIPT is a trademark of Adobe Systems Incorporated.
       Times and Helvetica are registered trademarks of Linotype.

Adobe Systems		       27 February 1991			   ENSCRIPT(1)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OPENSTEP

List of man pages available for OPENSTEP

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