home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / list / pr2-pr3.lbr / PR.DZC / PR.DOC
Text File  |  1988-02-16  |  6KB  |  142 lines
  1.         --- Documentation for Versions 2 and 3 of PR ---
  2.  
  3.         PR is a file print utility for use with Epson and Gemini
  4.     printers.  I am releasing it into the public domain with no
  5.     strings attached.
  6.         Version 2 of PR was written in BDS C, using version 1.50a
  7.     of the compiler.  Version 1.6 of WILDEXP was linked with the
  8.     PR2.CRL file, and the -n switch of L2 was used.
  9.         Version 3 of PR was written in Eco-C using version 3.40
  10.     of the compiler.
  11.         The C source files which are included in the .LBR file
  12.     can be used to modify PR2 or PR3 for use with other printers.
  13.  
  14.                         - Al Shrock 8/10/85
  15.                     (version 2 - last revised 9/3/86)
  16.                     (version 3 - last revised 3/29/87)
  17.  
  18.     Version 2 of PR has the following features:
  19.       -  automatic paging w/ filename & page number on each page.
  20.       -  high-bit masked during printing (can be suppressed).
  21.       -  automatic left margin indentation (can be suppressed).
  22.       -  automatic filtering of control characters (can be suppressed).
  23.       -  command line switches to allow customized output.
  24.       -  enhanced wildcard expansion of ambiguous filenames.
  25.  
  26.     To invoke PR2, use the following form:
  27.             pr [-cfhinst] [u/d:]filename.ext
  28.  
  29.         The filename.ext can be unique such as PR.DOC, or it can
  30.     be ambiguous such as *.DOC, or PR.D??, or even *.* for all
  31.     files.    Preceeding the filename with a '!' will cause PR to
  32.     exclude any files matched by filename.    For example, !*.COM
  33.     matches all files on the disk except the .COM files.  Multiple
  34.     filenames may be specified on PR2's command line.
  35.  
  36.         The parts of the command line enclosed by brackets are
  37.     optional.  The [u/d:] refers to user and drive specification
  38.     which may be ommitted if the file exists in the current user
  39.     area, and the default drive.
  40.  
  41.     The switches have the following interpretation:
  42.       -  the 'c' switch requests a compressed printout.
  43.       -  the 'f' switch suppresses control character filtering.
  44.       -  the 'h' switch suppresses high-bit masking.
  45.       -  the 'i' switch suppresses left margin indentation.
  46.       -  the 'n' switch requests line numbering of the text.
  47.       -  the 's' switch requests a subscript font printout.
  48.       -  the 't' switch changes the width of tab characters to 4.
  49.  
  50.     The following tables summarize the characteristics of the
  51.     command line switches:
  52.  
  53.              |   -i   |  -c, -s, -n  |  otherwise
  54.     -------------+--------+--------------+-------------
  55.      left margin |      0   |       8      |     5
  56.  
  57.              |  -c, -n  |   -s   |  otherwise
  58.     -------------+----------+--------+-------------
  59.      page length |    80    |  144   |     60
  60.  
  61.              |  -c, -s, -n  |  otherwise
  62.     -------------+--------------+-------------
  63.      line length |     136 (*)  |     80 (*)
  64.  
  65.     (*) - usable text line length is altered depending on the left
  66.     margin, as well as the presence of line numbers.
  67.  
  68.  
  69.         The order of multiple switches on the command line is not
  70.     important.  For example, '-tc' is the same as '-ct'.
  71.  
  72.         There is no point in specifying the 'c' switch if the
  73.     'n' or 's' switches are also being used, since these switches
  74.     will automatically cause compressed print to be selected.
  75.  
  76.  
  77.     Version 3 of PR has the following features:
  78.       -  automatic paging w/ filename & page number on each page. (*)
  79.       -  high-bit masked during printing.
  80.       -  automatic left margin indentation. (*)
  81.       -  automatic filtering of control characters.
  82.       -  command line switches to allow customized output.
  83.  
  84.         (*) - only paging occurs in landscape mode
  85.  
  86.     To invoke PR3, use the following form:
  87.             pr [-cln] [d:]filename.ext
  88.  
  89.         The parts of the command line enclosed by brackets are
  90.     optional.  The [d:] refers to drive specification which may
  91.     be ommitted if the file exists on the default drive.
  92.  
  93.         PR3 expects only one unambiguous filename to be specified,
  94.     the wildcard expansion of PR2 is not available in PR3.
  95.  
  96.     The switches have the following interpretation:
  97.       -  the 'c' switch requests a compressed (sub-script) printout.
  98.       -  the 'l' switch requests landscape (sideways) print mode.
  99.       -  the 'n' switch requests line numbering of the text.
  100.  
  101.     The following table summarize the characteristics of the
  102.     command line switches:
  103.  
  104.                 +-------------+-------------+-------------+
  105.                 | line length | left margin | page length |
  106.         +-------+-------------+-------------+-------------+
  107.         |       |     128     |      8      |      80     |
  108.         |   -n  |     120     |      8      |      80     |
  109.         |   -c  |     128     |      8      |     144     |
  110.         |   -l  |     105     |      0      |      60     |
  111.         |  -cn  |     120     |      8      |     144     |
  112.         +-------+-------------+-------------+-------------+
  113.  
  114.         The order of multiple switches on the command line is not
  115.     important.  For example, '-cn' is the same as '-nc'.
  116.  
  117.  
  118.     Special Notes:
  119.  
  120.         There are 2 copies of the .COM files included in the
  121.     library.  PR2.COM and PR3.COM are the Epson versions, and
  122.     PR2-G.COM and PR3-G.COM are the Gemini versions.
  123.  
  124.         I have left in the extra code that I include in my personal
  125.     copies of PR2 and PR3.  It presumes use with a Wyse WY-50
  126.     (or compatible) terminal.  It makes use of the host message
  127.     area to show what file and page number are currently being
  128.     printed.  This is handy if you use a printer buffer.  The extra
  129.     code is only in the .C source files, the .COM files were compiled
  130.     without it.
  131.  
  132.         PR3.REL and PR3-G.REL have been included in the library to
  133.     allow changes to the font used for landscape printing without
  134.     needing Eco-C.  CHSET.MAC and CHSET.REL are the source and
  135.     relocatable files for the landscape character set.  Simply edit
  136.     CHSET.MAC, which is the character data in binary format, then
  137.     assemble using a relocating assembler.  Link the new character
  138.     set with the appropriate version 3 .REL file to generate a new
  139.     .COM file.  This beats trying to wade through nearly two pages
  140.     of decimal (or worse yet, hexadecimal) initializers in the .C
  141.     source file.
  142.