Help Page for printPS


 Program: printPS, (C) 1991-2004,2010,2012 Miroslav Kolar (18 Nov 2012 version)

 Purpose: To convert ASCII files to PostScript + some extensions
 =======
  Up to 8 logical pages on a single sheet of paper in various formats.
  Arbitrary font size and number of lines per page. Control character
  visualization, overprinting the preceding character, and multilevel
  subscripts and superscripts also available.

 Usage:
  printPS
  printPS [-]-h[elp]   (to get more extensive help)
  printPS [options] [-] [file [[options] [-] file ... [-]]] [| lpr -Pprinter]
    - (if last argument) ... process standard input
    - (otherwise) ... next argument is a file name (may start with a '-')

  options: {-A4 -LTR -LGL} -sFirstpage -eLastpage {-wr -tr} {-sson -ssoff}
           {-port  -land  -2land  -4port  -port1 -land1 -2land1 -4port1}
           {-port2 -land2 -2land2 -4port2 -portT -landT -2landT -4portT}
           {-dh -HHeader -noH} {-bxon -bxoff} -fnFont -fhFont -linesLines
           {-numon -numoff}  {-Ig -Sp -Sh -ShAll}  -cpCopies  {-y2 -yA}
           {-encEncoding}
  All options are case-insensitive, except for the Header string.

  Orientation:
                   1-sided      2-sided printing with flip about
                   printing     long edge    short edge (tumble)
   portrait:       -port1       -port[2]        -portT  
   landscape:      -land1       -land[2]        -landT  
   2-up landscape: -2land1      -2land[2]       -2landT  
   2x2 portrait:   -4port1      -4port[2]       -4portT  

  Long lines: -tr ... truncate;  -wr ... wrap around  (has effect for the
              Courier fonts only)
  -dh ... use default header made of file name and Last Modification Time (LMT)
  -y2/A ... print only the last 2/all digits of the year of the LMT
  Header = user supplied header string
  -noH ... no header line printed
  -bxoff/on ... (do not) draw box around each page
  -fn ... font for the main text
  -fh ... font for headers
  Both fonts can be one of the following:
  Font = #    ... Courier                 (# is the height in points - 
         B#   ... Courier-Bold             an arbitrary positive number;
         O#   ... Courier-Oblique          72 points = 1 inch)
         BO#  ... Courier-BoldOblique
         H#   ... Helvetica
         HB#  ... Helvetica-Bold
         HO#  ... Helvetica-Oblique
         HBO# ... Helvetica-BoldOblique
         A#   ... AvantGarde-Book
  Lines = maximum number of lines on a page
  -numoff/on ... (do not) print line numbers
  Control character rendering: -Ig ; -Sp ; -Sh ; -ShAll (see below)
  Sub/superscript control: -sson (enabled); -ssoff (disabled) (see below)
  Copies = number of copies to be printed
	The following two options must appear before the 1st file name:
  Paper size: -A4 (21 x 29.7 cm) ; -LTR (8.5" x 11") ; -LGL (8.5" x 14")
  Encoding: Standard ; Latin1 ; Latin2 ; Cyril
       (i.e., ASCII, ISO8859-1, ISO8859-2, ISO8859-5)

 Defaults: -dh  -yA  -cp1  -port2  -wr  -Ig  -LTR  -ssoff  -s1
           -e0 (= print till the end of file)
           -lines0 (= calculate reasonable default for each font height)
           -bxon  -numoff  -fhH8  -encLatin1
           -fn9  (for all  -port  and  -land)
           -fn7  (for all  -2land  and  -4port)

 Examples:
 printPS -port -e5 -fnB16.5 - -a -s3 -H -4port graph.c -HDATA fil3
   (the first 5 pages of the file -a and pages 3 to 5 of graph.c and fil3)
 printPS -LGL -2landT -fn8 code.c
   (paper-saving well-readable printout of computer code)
 iconv -f UTF-8 -t LATIN1//TRANSLIT uni.txt | printPS -H -bxoff - | lpr
 iconv -f UTF-8 -t LATIN2//TRANSLIT uni.txt | printPS -encLatin2 ... - | lpr
 iconv -f UTF-8 -t CYRILLIC//TRANSLIT uni.txt | printPS -encCyril ... - | lpr
   (uni.txt is a UTF-8 encoded itext file containing a mixture of, respectively,
   all West-European languages, all East-European Latin-based languages, and
   all East-European Cyrillic languages; the last example would actually print
   a readable mixture of all three groups, but with all accents missing)

  Control characters are either ignored (option -Ig), or printed as
  spaces (option -Sp), or shown as capital letters with a caret (circumflex
  accent) above them (option -Sh), except for ^H, ^I, ^J, ^L, and when -sson
  is on, also ^^, ^_ and ^]. Backspace (^H), Tab (^I), Newline (^J) and
  Formfeed (^L) retain their natural functions in all three cases.
  When -sson is on, ^^ and ^_ can be used to mark the beginning
  of superscripts and subscripts, respectively, and ^] their end.
  Multiple-level sub/superscripts are allowed, e.g. A^^B^_c^^a^]d^_3^]^]^].
  Backspace can be used for overprinting of two or more characters
  (e.g. for underlining) and Formfeed for page breaks. Tabs are expanded.

  If option -ShAll is specified, all control characters will be shown
  and only Newline will retain its function.

  For Courier fonts, long input lines are either truncated or printed on
  several output lines (wrapped around). In each case, a small double
  right angle bracket marks the end of an unfinished line. In case of
  input lines that do not fit on one output line, long sequences of
  consecutive Backspaces may sometime not be rendered correctly (for -Ig,
  -Sp or -Sh only). For the proportional Helvetica and AvantGarde-Book
  fonts, long lines are always clipped at the right page margin.
go back