home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 223.lha / AsciiToPostScriptII / a2ps.1.cat < prev    next >
Text File  |  1989-03-29  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.                                                          A2PS(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      a2ps - formats an ascii file for printing in a postscript
  10.      printer; very nice and compact format for program listings.
  11.  
  12. SYNOPSIS
  13.      a2ps [ -b ] [ -f ] [ -i ] [ -n ] [ -n{bfinrv} ] [ -r ] [ -v
  14.      ] [ file1 ] [ file2 ] [...]
  15.  
  16. DESCRIPTION
  17.      a2ps formats files "file1", "file2", ... for printing in a
  18.      postscript printer; if no file is given, a2ps reads from the
  19.      standard input.  Format used is very nice and compact: two
  20.      pages on each physical page, borders surrounding pages,
  21.      headers with useful information (page number, printing date,
  22.      file name), line numbering, etc. Very useful to archive
  23.      listings of programs.
  24.  
  25.      Options offered by a2ps are the following:
  26.  
  27.      -b    Force printing binary files. By default, binary files
  28.            printing is stopped before second page (see -nb
  29.            option).
  30.  
  31.      -f    Fold lines too large to be printed inside the borders
  32.            (default option).  Max size is actually 86 characters.
  33.  
  34.      -i    Interpret TAB, BS and FF characters (default option).
  35.            TAB is replaced by enough spaces to reach next tab
  36.            stop while BS and FF have their meanings.
  37.  
  38.      -n    Output lines are preceded by line numbers, numbered
  39.            sequentially from 1 (default option).
  40.  
  41.      -nb   Don't print binary files. To detect such a file we
  42.            make use of a very simple heuristic: if the first page
  43.            of the file contains at less 75% of non-printing char-
  44.            acters, it's a binary file. First page is always
  45.            printed.
  46.  
  47.      -nf   Cut lines too large (don't fold).
  48.  
  49.      -ni   Don't interpret TAB, BS and FF characters. They will
  50.            be printed according to -v option.
  51.  
  52.      -nn   Don't number output lines.
  53.  
  54.      -nr   Sheet numbering (see -r option) must be continue for
  55.            all files (don't reset on new file).
  56.  
  57.      -nv   Replace non-printing characters by a space.
  58.  
  59.      -r    Reset sheet numbering for each new file (default
  60.  
  61.  
  62.  
  63.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. A2PS(1L)
  71.  
  72.  
  73.  
  74.            option). Sheet numbering is used to number physical
  75.            pages (sheets printed) and is placed in the bottom of
  76.            each physical page. It differs from page numbering:
  77.            logical pages of file been printed.
  78.  
  79.      -v    Replace non-printing characters so that they are lisi-
  80.            ble and easy to identify (default option). Control
  81.            characters (ascii codes lower than 0x20) are printed
  82.            like ^X for ctrl-x; the delete character (hex 0x3f) is
  83.            printed as ^?. Non ascii characters (with the high bit
  84.            set) are printed as M- (for meta) followed by the
  85.            character of the low 7 bits. TAB, BS and FF are han-
  86.            dled like non-printing characters if -ni option was
  87.            taked.
  88.  
  89. USAGE
  90.      a2ps sends formatted file to standard output. User could
  91.      redirect this output to a file or pipe it directly to a
  92.      print command, like lpr in UNIX:
  93.  
  94.           a2ps file1 > file2
  95.  
  96.           a2ps file1 | lpr -l
  97.  
  98.      Don't forget -l option in last line, if you want that lpr
  99.      interprets your postscript program.
  100.  
  101.      This filter must be used only with text files. Avoid spe-
  102.      cially output from TeX, troff or any other text formatter.
  103.  
  104. SEE ALSO
  105.      pprps(1L) tgrind(1) lpr(1)
  106.  
  107. AUTHORS
  108.      Evan Kirshenbaum (evan@csli) for the initial version.
  109.      Miguel Santana (miguel@imag.imag.fr) for 2.0 version.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. 2
  130.  
  131.  
  132.  
  133.