home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / p.lbr / PRINT.HZP / PRINT.HLP
Encoding:
Text File  |  1991-11-18  |  7.5 KB  |  133 lines
  1. ;
  2.                                   PRINT.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                6k (48)   1F8D  2.3        Bruce Morgen 3/91        Z3COM7
  6.  
  7.   1- Syntax  2- Options  3- Notes  4- Examples of Use                         
  8.  
  9.  
  10.    The PRINT command, like the LIST command,  prints a file on the LST: device
  11. but offers many more options.  It can print a heading,  page the file,  number
  12. the pages,  number the lines,  place a date/time stamp on the output,  put the
  13. file name on the output, and perform yet other functions.  
  14.  
  15.    PRINT is configurable without reassembly using  ZCNFG and includes the Date
  16. and Time in the page header if you are using  ZSDOS,  ZDDOS,  Z3PLUS, or Date-
  17. Stamper and have a real time clock installed and and active.  PRINT uses file-
  18. stamps whenever they are available, otherwise it uses the current system time.
  19. :1
  20.     Syntax   PRINT dir:afn1, dir:afn2,... o...
  21.  
  22.    While PRINT is running, the following commands work:
  23.  
  24.       ^C   <-- abort and return to operating system
  25.       ^X   <-- skip to top of next page and skip to next file
  26.  
  27.  
  28.    The characteristics of the  printer are  defined  by the  ZCPR3 environment
  29. descriptor.   Such  characteristics include  the number of physical lines on a
  30. page, the number of lines of text on  a page,  the  number of  characters  per
  31. line, and whether the printer can form feed or not.   The environment descrip-
  32. tor contains options for four  printers,  and the CPSEL utility can be used to
  33. select the desired set of attributes.
  34. :2
  35.     Options 
  36.            
  37.     E                    <-- exact print (expand tabs, form feed, no line or
  38.                                page numbers, no heading)
  39.     F                    <-- toggle default of file name display on page hdr
  40.                                (default is ON, so F turns off name display)
  41.     H<delim>text<delim>  <-- define heading text to appear at top of each page
  42.     I                    <-- inspect files before printing begins
  43.     L                    <-- enable numbering of each line
  44.     M                    <-- disable multiple run flag (if multiple run is ON,
  45.                                then no 'Set Top of Form' msg appears for each
  46.                                file and PRINT moves from one file to another
  47.                                unattended; default is with multiple run ON)
  48.     N                    <-- disable numbering of each page
  49.     On                   <-- offset each line.  move each line in indicated
  50.                                number of chars from the left of the page
  51.     Sn                   <-- start printing on page n
  52.     T                    <-- toggle date/time stamp in the header of each page
  53.                                (a TIME subroutine must be assembled into
  54.                                PRINT to enable the date/time stamp feature) 
  55. :3
  56.  PRINT Notes - 1/3 
  57.  
  58.    a. Version 2.3 updates (3/8/91, Bruce Morgen):
  59.       - Implemented A.E.'s  "E" proposal in  a  somewhat  different  way:  the
  60.         file's modify date is used in the header if it is available, otherwise
  61.         the system date is used.  To facilitate coding this, PRTLIB was modif-
  62.         ied to display  hh:mm instead of  hh:mm:ss (DS-style file stamps don't
  63.         bother with seconds).  
  64.       - Now  requires  DSLIB 4.3a  or  later in  addition  to  PRTLIB,  Z3LIB,
  65.         SYSLIB1, and SYSLIB0.  
  66.       - Quite a bit of code  crunching  (encouraged by  A.E.'s improvements to
  67.         the source organization and program flow) was done to keep the program
  68.         at 6K.  
  69.       - Fixed a bug that truncated filenames in the printed header.
  70.       - Eliminated alternate accumulator (AF') usage in  PRTLIB for the occas-
  71.         ional BIOS that expects it to be available unchanged.   No  changes to
  72.         the CFG required -- there are enough options as it is!
  73.  PRINT Notes -2/3 
  74.  
  75.    b. Version 2.2 updates (12/27/88, Al Hawley):
  76.       - This is a prerelease version of PRINT22.  Further enhancements (see E)
  77.         are anticipated, and the PRTLIB may be replaced with the new DSLIB (by
  78.         Hal Bower) when it is released, since many of the functions are almost
  79.         identical to those in PRTLIB.   The code in  PRTLIB  benefits  greatly
  80.         from code fragments and advice from  Cam Cotrill  (ZSDOS),  Hal  Bower
  81.         (ZSDOS, DSLIB), Bridger Mitchell and Howard Goldstein (JULIAN.LBR).
  82.       - A) Converted source code to Z80  mnemonics,  starting  with  R. Conn's
  83.         Version 2.0 since the plan was to implement Date/Time as a Rel Library
  84.         routine (as Conn implied) instead of an overlay.
  85.       - B) Reorganized source code to make the program flow clearer.
  86.       - C) Removed run-time variables from the  front of the  program, leaving
  87.         only parameters that comprise  configuration data.  This initial block
  88.         of data is now configurable at  run  time with  ZCNFG or  other patch/
  89.         debug utilities.  Included  a  separate file, PRINT.CFG and its source
  90.         code for configuration of PRINT with ZCNFG.
  91.  PRINT Notes - 3/3 
  92.  
  93.       - D) Removed conditional  assembly  around  TIME-related code,  added  a
  94.         separate module to  be included  at  link  time:  PRTLIB.REL  (and its
  95.         source code).   This  module includes the TIME  routine that   R. Conn
  96.         specified,  along with code  modules to  establish the identity of the
  97.         Operating System DOS,  and to  read the system clock if it is present.
  98.         An  initialization  routine in  PRTLIB,  GT_OSD  (GeT Operating System
  99.         Data) returns a pointer to a data structure whose elements may be hot-
  100.         patched to  provide  an interface to  a  user-defined  Real-Time-Clock
  101.         (i.e. interfaces other than DateStamper, CP/M 3.0, ZSDOS, and ZDDOS).
  102.       - E) UNFINISHED-  Use of file datestamps is not implemented.  File date-
  103.         stamps,  if available,  could be included at the  expense  of an added
  104.         header line in the printed output.   It would also be  possible to set
  105.         a configuration  option to  include  Create,  Modify, and  Access file
  106.         datestamps as desired.
  107.  
  108.    c. Version 2.1 updates (3/22/85, Joe Griffith):
  109.       - Modifies the orignal 2.0  code to  accept the  TM-XXXnn.ASM  real-time
  110.         clock overlays.  Once loaded and installed, the T option is functional
  111.         and when invoked will print the current date/time stamp on each page.
  112. :4
  113.  Examples of Use 
  114.  
  115.    a. PRINT with  the  L  option  is the  quickest  and most convenient way to
  116.       print out long aliases.  PRINT word-(line) wraps  based  on the environ-
  117.       ment descriptor,  which  stores four printer line widths.  CPSEL selects
  118.       the active one.  When  a line  goes beyond  the  printer's capability, a
  119.       new line is started automatically.  Double left-pointing arrows (<<) are
  120.       placed at  the  end of  a line to indicate a wrap has occurred.  Correct
  121.       pagination occurs automatically, no matter  how many  wraps occur.  Best
  122.       of all,  the L  option numbers each line, so each alias multiple-command
  123.       line is numbered.  A  line without  a number  is easily distinguished as
  124.       an extension of the previous line.
  125.  
  126.    b. PRINT text:*.txt,*.txt o10n
  127.  
  128.       - print  all *.txt files  in  the  TEXT: directory  and in  the  current
  129.         directory; offset all lines by 10 columns, and don't number pages
  130.  
  131.    c. PRINT myfile.txt s25    
  132.  
  133.       - print MYFILE.TXT starting at page 25