home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / print23.lbr / PRINT.DZC / PRINT.DOC
Encoding:
Text File  |  1993-10-25  |  3.9 KB  |  90 lines

  1.                           PRINT.DOC
  2.                           ---------
  3.                  Documentation for PRINT.COM
  4.                     v2.3 - Eric Meyer 3/85 
  5.  
  6.  
  7.      PRINT.COM is a file printing utility, originally written
  8. in C; version 2.0 has been rewritten in 8080 assembler, and is
  9. much smaller (1K) and faster.  It is designed to give attractive,
  10. practical printouts of text files, with comfortable margins, and
  11. the filename and page number on each page top.
  12.      Version 2.1 added better Wordstar support.  V 2.2 fixed a
  13. bug which often caused PRINT to fail to print a file under CP/M
  14. 2.2. Version 2.3 fixes a bug which caused header comments to print
  15. incorrectly.
  16.  
  17. SYNTAX:
  18.      The only argument required is a valid filename.  However,
  19. there are many convenient options.  The general syntax is:
  20.  
  21.                A>print filename.typ [options]
  22.  
  23. "Options" may be specified in any order, with or without spaces
  24. between them.  Make sure your printer is set up as you wish
  25. (margins, pitch etc) beforehand.
  26.      You may abort PRINT with control-C (^C).
  27.  
  28. OPTIONS:  (The first two are especially useful for WordStar files.)
  29.  
  30. '.' - Instructs PRINT to ignore WordStar dot commands.  Any lines
  31.    beginning with a period (after a hard carriage return) will
  32.    NOT print out when this option is in effect.
  33.  
  34. '^' - Selects control-code filtering.  All control codes (except
  35.    CR and LF) will be replaced by two characters; thus DC3 (^S)
  36.    will print as "^S".  In this mode, a Wordstar file will print
  37.    out much as it looks on your screen during editing.
  38.      In default mode, all control codes are sent directly out.
  39.    Thus you can, for example, get files with tabs and formfeeds
  40.    printed properly, or put ESC codes for your printer in a
  41.    file; on the other hand, nasty codes will also act (e.g. ^S
  42.    will cause printing to stop).
  43.  
  44. '@mm' - Begins actual printing "at" page number 'mm' (as counted
  45.    by PRINT!)   If the file isn't that long, nothing will print.
  46.    The default is of course "@1".
  47.  
  48. '#nn' - Prints out at most 'nn' pages.  The default is "#255".
  49.    (Note: PRINT cannot count beyond 255 pages.)
  50.  
  51. "comment" - Puts the quoted comment, up to about 50 characters,
  52.    at the top of each page, after the filename and page number.
  53.    Useful for adding a date, or any other remarks.  Be aware
  54.    that the usual CP/M uppercase conversion will occur.
  55.  
  56. รจ'-' - Suppresses the page header (filename and page number).
  57.    Each page will hold 4 more lines as a result.
  58.  
  59. '?' - Displays the file on your screen, instead of printing it.
  60.    Good for proofreading, finding pages you wish to print, etc.
  61.    The display moves quickly; use ^S to pause and examine it.
  62.  
  63. EXAMPLES:
  64.  
  65. A>PRINT B:MY.DOC
  66.    This whole file will print out, with the filename and page number
  67.    on every page top.
  68. A>PRINT B:MY.DOC .^
  69.    This file will be printed, with dot commands ignored, and control
  70.    codes filtered.  A good way to study a WordStar rough draft.
  71. B>a:print my.doc #3"rough draft"
  72.    The first three pages of the file will be printed, with the
  73.    comment ROUGH DRAFT in the header on each page top.
  74. A>PRINT B:MY.DOC @10#4 ?-
  75.    Pages 10 to 13 will be viewed at the terminal, with no page headers.
  76.  
  77. USER PATCH:
  78.      By default, PRINT prints 54 text lines per page, and the header
  79. takes another 4 lines, leaving 8 of the standard 66 lines blank for
  80. vertical margins.  This was chosen for compatibility with my FTNOTE
  81. program, which also prints 54 lines per page.  You can change this
  82. number to suit yourself by patching location 0104H in PRINT.COM.  The
  83. default value is 36H (54 lines).
  84.  
  85. ERROR MESSAGES:
  86.      These are all fairly self-explanatory.
  87. ++ No file ++         The file given does not exist.
  88. ++ Bad option ++      You specified an illegal option.
  89. ++ Read error ++      PRINT cannot continue reading the file.
  90. ++ Aborted ++         You typed a ^C.
  91.