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 / ZSYS / ZNODE-12 / I / ITOZ14.LBR / ADNAME.HZP / ADNAME.HLP
Text File  |  1992-04-05  |  7KB  |  161 lines
  1. ;
  2.                                   ADNAME 
  3.                                 Version 1.2
  4.  
  5.                                Gene Pizzetta
  6.                                April 5, 1992
  7.                    Original program by Robert Doolittle
  8.  
  9. ADNAME adds pseudo-ops and macro names to ITOZ which would otherwise be 
  10. unrecognized.  When ITOZ encounters a line in a source containing a pseudo- 
  11. op corresponding to one added via ADNAME, it copies the line to the output 
  12. file without attempting to translate it.  ADNAME is a ZCPR3 utility, but 
  13. can also be used under vanilla CP/M in the current user area.
  14.  
  15.            U  Usage                         C  Configuration
  16.            E  Errors                        H  History       
  17.            D  Date stamping                 B  Bug reports
  18. :U
  19.  
  20.                                    USAGE
  21.  
  22.  
  23.      ADNAME {dir:}infile {dir:}{outfile}
  24.  
  25.  
  26. Filenames must be unambiguous.  If no filetype is given, ADNAME assumes it 
  27. is "COM".  If no DIR or DU specification is given, the current drive and 
  28. user are assumed.  If no destination filename is given, the output will 
  29. have the same name as the source file.  An existing file with the same name 
  30. as the destination file will be renamed to filetype "BAK".
  31.  
  32. Drive specifications are effective under vanilla CP/M, but only the current 
  33. logged user area is used.  Of course, other ZCPR3 features, such as setting 
  34. the error flag, invoking the error handler, video highlighting, and 
  35. detection of illegal drive specs, do not work either.
  36.  
  37. ADNAME prompts the user for the pseudo-ops and macro names to be added to 
  38. ITOZ.  They are entered one name per line.  A blank line ends input.  
  39. Typing ^C anywhere on an input line aborts the program with the original 
  40. file unchanged.
  41.  
  42. USAGE (continued)
  43.  
  44. ITOZ has 200 bytes available for adding pseudo-ops, but each added name 
  45. requires two bytes in addition to the length of the name.  This can be 
  46. calculated as 2 * NUMBER_OF_NAMES + TOTAL_CHARACTERS, which must total less 
  47. than 200.  ADNAME will not allow the limit to be exceeded; in that case it 
  48. aborts with an error message and the original file is unchanged.
  49.  
  50. ADNAME adds the names entered to any names previously added.  Names are 
  51. never removed from ITOZ.  For this reason, you should always have an 
  52. unchanged back-copy of ITOZ.  As added safety, if an existing file has the 
  53. same name as the destination file, it is preserved as a "BAK" file.
  54. :E
  55.  
  56.                                   ERRORS
  57.  
  58. Errors cause the ZCPR3 program error flag to be set to the following 
  59. values:
  60.  
  61.        2  Invalid directory
  62.        4  Source file not correct ITOZ version,
  63.           or overflow of ITOZ buffer space
  64.        8  Ambiguous filename
  65.       10  Source file not found
  66.       11  No disk or directory space
  67.      255  User abort (^C)
  68.  
  69. Whether a user abort via ^C generates an error is a configurable option 
  70. (see CONFIGURATION).  All errors cause the error handler to be invoked.
  71. :D
  72.  
  73.                                DATE STAMPING
  74.  
  75. Under ZSDOS the create date stamp of the source file will be transferred to 
  76. the destination file.
  77.  
  78. If the source file has no create date, but has a modify date, the modify 
  79. date will become the create date of the destination file, so the earliest 
  80. available date is preserved.
  81.  
  82. If the source file has neither a create date nor a modify date, no date 
  83. stamp transfer is done.
  84. :C
  85.  
  86.                                CONFIGURATION
  87.  
  88. Although distributed ready-to-run under both ZCPR3 and vanilla CP/M, two 
  89. configuration options are available:  whether ADNAME operates in quiet 
  90. mode, and whether a user abort via ^C causes an error and thus invokes the 
  91. error handler.
  92.  
  93. Configuration is accomplished using Al Hawley's ZCNFG with the accompanying 
  94. ADNAMEnn.CFG file.  Built-in help screens explain the configuration 
  95. choices.  If you don't change the name of the CFG file, ZCNFG will always 
  96. be able to find it even if you change the name of ADNAME.
  97. :H
  98.  
  99.                                   HISTORY
  100.  
  101. Version 1.2 -- April 5, 1992 -- Gene Pizzetta
  102.      Modified for ITOZ 1.4, this version retains little of Bob Doolittle's 
  103.      last version.  It has a completely new, hopefully more intuitive, user 
  104.      interface.  ADNAME can now read and write files across user areas 
  105.      (except under plain CP/M).  It recognizes DU and DIR specifications.  
  106.      The default filetype is "COM", but other filetypes may be given on the 
  107.      command line.  Any existing file with the same name as the output file 
  108.      is renamed to filetype "BAK".  The program error flag is set and the 
  109.      error handler invoked on error.  ADNAME can be aborted with ^C during 
  110.      pseudo-op entry.  A user abort can be configured to generate an error 
  111.      or not.  The ZCPR3 quiet flag is observed, or quiet operation can be 
  112.      made permanent via configuration.  Under ZSDOS the source file's 
  113.      create date stamp is transferred to the output file.  ADNAME now 
  114.      recognizes the "//" help request and displays a usage screen.  The 
  115.      source code was converted from extended Intel to Zilog mnemonics.  The 
  116.      large number of macros in a separate MACROZ.LIB were eliminated to 
  117.      ease code maintenance, and the code was made relocatable so library 
  118.      routines could be incorporated.  ADNAME returns to the CCP; it no 
  119.      longer warm boots on exit.  Configuration is accomplished with ZCNFG.
  120.  
  121. History of earlier versions by Robert Doolittle:
  122.  
  123. February 17, 1992
  124.      Released to the public domain by author Bob Doolittle.
  125.  
  126. September 28, 1982
  127.      Now version 1.12.  Changed START1 to make sure input file type is COM. 
  128.      Changed MV and routine in T2 to call MV.
  129.  
  130. September 13, 1982
  131.      Fixed BUF and BUF1 lengths (were 127).
  132.  
  133. August 16, 1982
  134.      Version 1.11, updated.  Trapped MAKE and WRITE disk errors.  This 
  135.      version expects pointer to TABLE at BUFFER+2 and total character count 
  136.      at BUFFER+4.  These parameters are updated and written back to disk in 
  137.      new translator file.  Each invocation of ADNAME will add new names 
  138.      without further ado.  Translator name can be anything.
  139.  
  140. July 24, 1982
  141.      Created.
  142.  
  143.                                 RD SOFTWARE
  144.                            1290 Monument Street
  145.                         Pacific Palisades,CA 90272
  146.                               (213) 454-8270
  147. :B
  148.  
  149.                                 BUG REPORTS
  150.  
  151. Please report bugs as soon as possible and make suggestions at your 
  152. leisure:
  153.  
  154.                                Gene Pizzetta
  155.                              481 Revere Street
  156.                              Revere, MA 02151
  157.  
  158.                           Voice:  (617) 284-0891
  159.                    Newton Centre Z-Node:  (617) 965-7259
  160.                   Ladera Z-Node Central:  (310) 670-9465
  161.