home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / ZSUS009.LBR / Z3HELP28.LBR / PRTASM.HZP / PRTASM.HLP
Text File  |  2000-06-30  |  7KB  |  155 lines
  1. ;
  2.                                  PRTASM.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. PRTASM.CIM     5k (35)   6078  1.9        Gene Pizzetta 7/90       Z3COM9
  6. PRTASM.COM     5k (35)   3B21  1.9        Gene Pizzetta 7/90       Z3COM9
  7.  
  8.   1- Usage  2- Expanding Tabs  3- Modifications  4- Notes                     
  9.  
  10.    PRTASM is  a ZCPR3 utility  that prints  assembly  source  code  and  other
  11. program listings  on the CP/M LST device.   It  prints  the  filename and page 
  12. number in the upper  right  corner  of  each page.   If  a real-time  clock is
  13. available under ZDOS or DateStamper, the file stamp modification date and time
  14. is printed to the left of the filename.  If no modification date is available,
  15. PRTASM tries for a  creation date.   If neither date stamp is  available,  the
  16. current date and time are used instead.  If no clock is available, no date and
  17. time are printed at all.   It is configured for Epson printers  and runs under 
  18. ZCPR 3.x only.  Vs 1.0 (9/17/87) by Gene Pizzetta.
  19. :1
  20.  Usage - 1/2   PRTASM {dir:}<fn.ft> {{dir:}<fn.ft} {...}
  21.  
  22.    At least one input  filename is required.   Names in the  file list  may be
  23. separated  by any number of spaces  and commas.   Ambiguous  filenames are not 
  24. accepted.   If no DU or DIR specification is given,  the current drive/user is 
  25. assumed.
  26.  
  27.    Once printing  has  begun,  pressing  any key will  abort  printing  of the 
  28. current file.   If the key is ^C,  PRTASM will return to the operating system; 
  29. otherwise, it will skip to the next file.
  30.  
  31.    If a  file cannot be found,  or if an  ambiguous  file spec is encountered, 
  32. PRTASM will display  an error message and then  continue with the next file in 
  33. the file list.  It will, however, set the program error flag on exit.
  34.  
  35.    The number of lines on  a printed page and  whether the  printer can handle 
  36. formfeeds is taken from the environment  descriptor.   Make sure these are set 
  37. properly.   It is particularly  desirable that  PRTASM use formfeeds so that a 
  38. line or two that overflows the margin will not get the header out of sync.
  39.  Usage - 2/2 
  40.  
  41.  
  42.    The distributed version is  configured for  Epson printers and compatibles,
  43. but is easily modified.  PRTASM expects, however, that your printer is capable
  44. of printing a 96-character line in elite pitch.
  45. :2
  46.  Expanding Tabs 
  47.  
  48.    Tabs are not expanded by PRTASM.   It is  assumed that most modern printers 
  49. are IBM-compatible and thus handle tabs correctly.  If your printer needs tabs
  50. sent as the  corresponding number of spaces,  run your file  through  a filter 
  51. program before printing it with PRTASM.   If you would prefer a future version 
  52. to expand tabs, please let the author know.
  53. :3
  54.  Modifications - 1/2 
  55.  
  56.    In the first sector of the COM file, immediately following the label MTIME,
  57. is a byte that determines the format of the time string printed in the header.
  58. If the byte is zero, 12-hour "civilian" time format ( 3:00p) is used.   If the
  59. byte is non-zero, 24-hour "military" time format (15:00) is used.
  60.  
  61.    Also in the first sector  are labels  for the  printer codes,  which can be 
  62. changed to work  with any printer.   The first byte  after each  label  is the 
  63. number of characters in the string, followed immediately by the string itself,
  64. which may be up to six bytes.
  65.  
  66.      ELISTR    The escape code to put the printer in elite pitch
  67.                (12 characters per inch).
  68.  
  69.      MARSTR    The escape code to set the  printer's left margin
  70.                to column 8.
  71.  
  72.      RSTSTR    The  escape  code  to  reset  the  printer  (this
  73.                program cleans up when it's through).
  74.  Modifications - 2/2 
  75.  
  76.      BOLDON    The escape code to put the printer into boldface,
  77.                emphasized,  or  double-strike  for  printing the
  78.                header.
  79.  
  80.      BOLDOF    The escape code to  cancel the printer's boldface
  81.                mode.
  82.  
  83.  
  84.  
  85.    PRTASM was developed using the SLRMAC assembler and SLRNK+ linker:
  86.      slrmac prtasm/m
  87.      slrnkp prtasm/n,/v,/a:100,/j,prtasm,zslib/s,dslibs/s,vlibs/s,
  88.          z3libs/s,syslibs/s,/e
  89. :4
  90.  PRTASM Notes - 1/4 
  91.  
  92.    a. Version 1.9 updates (7/18/90, Gene Pizzetta):
  93.       - Now prints source  of date and time:  "Modified",  "Created",  or just
  94.         "Printed" if no file stamp is available.  
  95.       - A few bugs have also been squashed,  1) failure to set the correct DMA
  96.         address if the military time flag was false;  2) if a  key was pressed
  97.         while the header was  being sent  to  the  printer,  PRTASM  would not
  98.         detect it.
  99.  
  100.    b. Version 1.8 updates (7/11/90, Gene Pizzetta):
  101.       - Modified to accept a list of files.  
  102.       - file date now  used in the header,  if it has  a  modification  (first
  103.         choice) or create stamp; otherwise, the current date is used.
  104.       - Back to Intel mnemonics.  
  105.       - If any files in the file list are not found,  PRTASM skips to the next
  106.         file after printing an error message.  
  107.       - Printing can be aborted at any time with ^C.  Any other key will abort
  108.         the file currently being printed and move to the next in the list.  
  109.       - A two-byte page counter is now used so it will number past 255.  
  110.  PRTASM Notes - 2/4 
  111.  
  112.       - Formfeeds in the file are trapped and  replaced with a single carriage 
  113.         return/linefeed.  
  114.       - A printer capable of 96 columns in elite pitch is assumed.  
  115.       - Page length and formfeed ability are obtained from the environment.  
  116.       - A configuration byte allows selection of civil or military time.  
  117.       - Patching for non-Epson escape codes no longer requires re-assembly.  
  118.       - Added a type-3 header.  
  119.       - Program error flag is set if any file in the file list cannot be found
  120.         or if a file specification is ambiguous.
  121.  
  122.    c. Version 1.7 updates (7/16/90, J. Mortensen):
  123.       - Translated to Zilog mnemonics.  
  124.       - Time of day added to header.
  125.       - ZSLIB routines added for printing time and date.  
  126.       - Added LST status check and ZCPR3 check.  
  127.       - Masks high bits for WordStar files.
  128.  PRTASM Notes - 3/4 
  129.  
  130.    d. Version 1.6 updates (8/7/89, Gene Pizzetta):
  131.       - minor change in header format
  132.  
  133.    e. Version 1.5 updates (7/26/89, Gene Pizzetta):
  134.       - now prints date in header line if a  real-time clock is  working under
  135.         DateStamper or ZDOS (must be linked with version 4 SYSLIB's)
  136.  
  137.    f. Version 1.4 updates (6/10/89, Gene Pizzetta):
  138.       - slight change in screen display
  139.  
  140.    g. Version 1.3 updates (3/11/89, Gene Pizzetta):
  141.       - adds DU filespec and ZCPR3 TCAP support
  142.       - incorporates SYSLIB routines
  143.       - now preserves the CP and no longer warm boots
  144.  PRTASM Notes - 4/4 
  145.  
  146.    h. Version 1.2 updates (10/13/88, Gene Pizzetta):
  147.       - eliminates CP/M Plus dependencies.  
  148.       - adds printer cleanup on user abort.   
  149.       - still sends a failure code to  the BDOS on error, to support CP/M Plus
  150.         conditional submits.   CP/M 2.2  doesn't recognize it,  but it does no 
  151.         harm.
  152.  
  153.    i. Version 1.1 updates (9/20/87, Gene Pizzetta):
  154.       - added page numbering and boldface filename in header
  155.