home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / print / ascii2ps / a2ps / a2ps.doc < prev    next >
Encoding:
Text File  |  1994-02-03  |  4.2 KB  |  134 lines
  1. LATEST INFO
  2. ===========
  3.  
  4. a2ps has been around a long time and produces very nice 2 page listings
  5. on single sheets of a4 in a postscript laser printer.  Many thanks to the
  6. original authors for this fine product.
  7.  
  8. This version has been rebuilt for OS2 (ver1.1 or higher) and the command file
  9. list.cmd has been added to simplify the user interface.  Current default for
  10. output is LPT1: but this can be changed (as can the temp file name) by 
  11. altering LIST.CMD.
  12.  
  13. USAGE
  14. =====
  15.  
  16. 1) Place the following line in config.sys
  17.  
  18.         "set header_ps=c:\<list>\header.ps"
  19.  
  20. where <list> is full path of file header.ps
  21.  
  22. 2) Put both list.cmd and a2ps.exe on a path which will be searched.
  23.  
  24. 3) Type command 
  25.  
  26.         "list <filename>"
  27.  
  28. for output.
  29.  
  30. Mac Scott 2/8/90
  31.  
  32.  
  33. OLD INFO
  34. ========
  35.  
  36. a2ps \- formats an ascii file for printing in a postscript printer;
  37. very nice and compact format for program listings.
  38.  
  39. SYNOPSIS
  40.    a2ps   [-b] [-f] [-i] [-n] [-n{bfinrv}] [-r] [-v] [file1] [file2] [...]
  41.  
  42. DESCRIPTION
  43. a2ps formats files "file1", "file2", ... for printing in a postscript 
  44. printer; if no file is given, a2ps reads from the standard input.
  45.  
  46. Format used is very nice and compact: two pages on each physical page,
  47. borders surrounding pages, headers with useful information (page number,
  48. printing date, file name), line numbering, etc. Very useful to
  49. archive listings of programs.
  50.  
  51. Options offered by a2ps are the following:
  52.  
  53.         -b
  54. Force printing binary files. By default, binary files printing is
  55. stopped before second page (see -nb option).
  56.  
  57.         -f
  58. Fold lines too large to be printed inside the borders (default option).
  59. Max size is actually 86 characters.
  60.  
  61.         -i
  62. Interpret TAB, BS and FF characters (default option). TAB is replaced by
  63. enough spaces to reach next tab stop while BS and FF have their meanings.
  64.  
  65.         -n
  66. Output lines are preceded by line numbers, numbered sequentially from 1
  67. (default option).
  68.  
  69.         -nb
  70. Don't print binary files. To detect such a file we make use of a
  71. very simple heuristic: if the first page of the file contains at
  72. less 75% of non-printing characters, it's a binary file. First page
  73. is always printed.
  74.  
  75.         -nf
  76. Cut lines too large (don't fold).
  77.  
  78.         -ni
  79. Don't interpret TAB, BS and FF characters. They will be printed
  80. according to -v option.
  81.  
  82.         -nn
  83. Don't number output lines.
  84.  
  85.         -nr
  86. Sheet numbering (see -r option) must be continue for all files (don't
  87. reset on new file).
  88.  
  89.         -nv
  90. Replace non-printing characters by a space.
  91.  
  92.         -r
  93. Reset sheet numbering for each new file (default option). Sheet numbering
  94. is used to number physical pages (sheets printed) and is placed
  95. in the bottom of each physical page. It differs from page numbering: logical
  96. pages of file been printed.
  97.  
  98.         -v
  99. Replace non-printing characters so that they are listable and easy to identify
  100. (default option). Control characters (ascii codes lower than 0x20) are
  101. printed like ^X for ctrl-x; the delete character (hex 0x3f) is printed
  102. as ^?. Non ascii characters (with the high bit set) are printed as M-
  103. (for meta) followed by the character of the low 7 bits. TAB, BS and FF are
  104. handled like non-printing characters if -ni option was taked.
  105.  
  106. USAGE
  107. a2ps sends formatted file to standard output. User could redirect this output
  108. to a file or pipe it directly to a print command, like lpr in UNIX:
  109.  
  110. a2ps file1 > file2
  111.  
  112. a2ps file1 | lpr -l
  113.  
  114. Don't forget -l option in last line, if you want that lpr interprets your 
  115. postscript program.
  116.  
  117. This filter must be used only with text files. Avoid specially output from
  118. TeX, troff or any other text formatter.
  119.  
  120. NB a2ps requires access to header file, which contains the Postscript
  121.    pre-amble. The file name should be put in the environment variable
  122.    HEADER_PS. If this variable is not defined a2ps will look in the
  123.    current directory. (This was added for the dos version).
  124.  
  125.  
  126. "SEE ALSO"
  127. pprps(1L) tgrind(1) lpr(1)
  128.  
  129. AUTHORS
  130. Evan Kirshenbaum (evan@csli) for the initial version.
  131. Miguel Santana (miguel@imag.imag.fr) for 2.0 version.
  132. Leslie Spiro for a two minute hack to build it under DOS
  133. Mac Scott one minute hack for OS/2 and creation of list.cmd file.
  134.