home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0797.lha / A2ps / a2ps.man < prev    next >
Text File  |  1993-01-10  |  5KB  |  198 lines
  1.  
  2.  
  3.  
  4.    24 July 1989                                                      A2PS(1L)
  5.  
  6.  
  7.  
  8.    NAME
  9.      a2ps - formats an ascii file for printing on a postscript printer
  10.  
  11.    SYNOPSIS
  12.      a2ps [ -#num ] [ [ -? ] [ -b ] [ -f ] [ -fnum ] [ [ -h ] [ -i ] [ -n ] [
  13.      -n{bfhinprsvw} ] [ -p ] [ -r ] [ -tnum ] [ -v ] [ -w ] [ _f_i_l_e ] ...
  14.  
  15.    DESCRIPTION
  16.      _a_2_p_s formats each named file for printing in a postscript printer; if no
  17.      file is given, _a_2_p_s reads from the standard input.  The format used is
  18.      nice and compact: normally two pages on each physical page, borders sur-
  19.      rounding pages, headers with useful information (page number, printing
  20.      date, file name), line numbering, etc. Very useful to archive listings
  21.      of programs.
  22.  
  23.      Options offered by _a_2_p_s are the following:
  24.  
  25.      -#num To get multiple copies of output, where _n_u_m is the number of
  26.            copies desired of each file named. By default, you get only one
  27.            copy.
  28.  
  29.      -?    Print usage information.
  30.  
  31.      -b    Force printing binary files. By default, binary files printing is
  32.            stopped before second page (see -nb option).
  33.  
  34.      -f    Fold lines too large to be printed inside the borders (default
  35.            option).  Max size depends on format and font size used.
  36.  
  37.      -fnum Changes font size to this value. Default values for font size are
  38.            6.8 in landscape mode and 9.0 in portrait mode. Try other sizes if
  39.            you think that these values are too small (or big).
  40.  
  41.      -h    Print usage information.
  42.  
  43.      -i    Interpret TAB, BS and FF characters (default option). TAB is
  44.            replaced by enough spaces to reach next tab stop while BS and FF
  45.            have their meanings.
  46.  
  47.      -n    Output lines are preceded by line numbers, numbered sequentially
  48.            from 1 (default option).
  49.  
  50.      -nb   Don't print binary files. To detect such a file we make use of a
  51.            very simple heuristic: if the first page of the file contains at
  52.            less 75% of non-printing characters, it's a binary file. First
  53.            page is always printed.
  54.  
  55.      -nf   Cut lines too large (don't fold).
  56.  
  57.      -nh   Don't print page headers.
  58.  
  59.      -ni   Don't interpret TAB, BS and FF characters. They will be printed
  60.            according to -v option.
  61.  
  62.  
  63.                                                                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    A2PS(1L)                                                      24 July 1989
  71.  
  72.  
  73.      -nn   Don't number output lines.
  74.  
  75.      -np   Don't print pages in portrait mode (see -p option) but in
  76.            landscape mode.
  77.  
  78.      -nr   Sheet numbering (see -r option) must be continue for all files
  79.            (don't reset on new file).
  80.  
  81.      -ns   Don't print page surrounding borders.
  82.  
  83.      -nv   Replace non-printing characters by a space.
  84.  
  85.      -nw   Don't use wide format (see -w option).
  86.  
  87.      -p    Print files in portrait mode, one page per physical sheet.  The
  88.            default option is to use landscape mode and print two pages on a
  89.            physical sheet. This option may not be used with the -w option.
  90.  
  91.      -r    Reset sheet numbering for each new file (default option). Sheet
  92.            numbering is used to number physical pages (sheets printed) and is
  93.            placed in the bottom of each physical page. It differs from page
  94.            numbering: logical pages of file been printed.
  95.  
  96.      -tnum Set TAB size to _n_u_m (default 8).  This option is ignored if -ni is
  97.            specified (see below).
  98.  
  99.      -v    Replace non-printing characters so that they are visible and easy
  100.            to identify (default option). Control characters (ascii codes
  101.            lower than 0x20) are printed like ^X for ctrl-x; the delete char-
  102.            acter (hex 0x3f) is printed as ^?. Non ascii characters (with the
  103.            high bit set) are printed as M- (for meta) followed by the charac-
  104.            ter of the low 7 bits. TAB, BS and FF are handled like non-
  105.            printing characters if -ni option was taked.  + .TP 0.6i -w Use
  106.            wide format pages. This will result in only one page per physical
  107.            sheet but in landscape mode. This option may not be used with the
  108.            -p option.
  109.  
  110.    USAGE
  111.  
  112.      _A_2_p_s sends formatted file to standard output. The user could redirect
  113.      this output to a file, pipe it directly to a print command (like lpr),
  114.      or pipe it to another filter for further processing.
  115.  
  116.           a2ps file1 > file2
  117.  
  118.           a2ps file1 | lpr -l -Pps
  119.  
  120.           a2ps -p file1 | psnup -n4 | lpr -l -Pps
  121.  
  122.      Don't forget -l option in _l_p_r , if you want that _l_p_r interprets your
  123.      postscript program.
  124.  
  125.      This filter must be used only with text files. Avoid specially output
  126.      from TeX, troff or any other such text formatters.
  127.  
  128.  
  129.    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.    24 July 1989                                                      A2PS(1L)
  137.  
  138.  
  139.  
  140.    SEE ALSO
  141.      tgrind(1) lpr(1) pprps(1L)
  142.  
  143.    AUTHORS
  144.      Evan Kirshenbaum (evan@csli) for the initial version.
  145.      Miguel Santana (miguel@imag.imag.fr) for versions 1.0, 2.0 et 3.0.
  146.      Daniel Barrett (barrett@cs.umass.edu) did a quick port to the Amiga.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                             3
  195.  
  196.  
  197.  
  198.