home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / zcat / timestmp.lbr / TIMESTMP.DQC / TIMESTMP.DOC
Text File  |  1991-01-31  |  4KB  |  111 lines
  1. Time stamp   VERS:- 00.02  DATE:- 07/31/82  TIME:- 22:13:09
  2.  
  3.  
  4. *************************************************************
  5. *
  6. * QUICK OVERVIEW:   Increment version and insert current date
  7. * ===============    and time for each assembly or edit run.
  8. *
  9. *************************************************************
  10.  
  11.  
  12. *************************************************************
  13. *
  14. *    File Tracking Program
  15. *    by Eric Forbes
  16. *    c/o Mississauga, Ont. Canada RCP/M System
  17. *     (416) 826-5394
  18. *
  19. *************************************************************
  20. Copyright (c) 1982, E. Forbes; permission granted to use,
  21. copy and distribute for non-commercial purposes.
  22.  
  23.  
  24. This program may be assembled to run as a stand alone COM 
  25. file or it may be added to an assembler so that each time a 
  26. file is edited or assembled the version number will be 
  27. incremented and the current date and time will be inserted 
  28. into the first record of the file.
  29.  
  30. This program loads the 1st record from a file and then looks 
  31. for 'VERS:- ', 'DATE:- ' and 'TIME:- ' When it finds any of 
  32. the three it will update ONLY that data. Each entry MUST be 
  33. exactly as shown, upper case characters, colon, minus and 
  34. space all with the high bit off. After updating, it writes 
  35. the modified record back to disk, to the same place, restores 
  36. the patched jump in the assembler / editor, decrements the 
  37. character count in the command line tail (80h) if an option 
  38. was used and jumps to the assembler / editor. The command 
  39. line and fcbs remain unchanged to ensure normal operation of 
  40. the assembler/editor. 
  41.  
  42. When creating a new text file insert 'VERS:- 00.00' and this 
  43. program will increment the minor number each time you run it 
  44. If the option 'm' is used, the major number will be incre- 
  45. mented and the minor zeroed. If the 'n' option is used, the 
  46. version number will be unchanged. 'M' and 'N' are mutually 
  47. exclusive. 
  48.  
  49. To use the 'DATE:- ' and 'TIME:- ' functions, this program
  50. expects to find three consecutive bytes at MONTH and HOUR,
  51. in BCD format. E.G. to print the date 07/31/82, the bytes
  52. 07H 31H 82H should be available at HOUR, HOUR+1 and HOUR+2
  53.  
  54. If you do not have a clock ignore the 'month' and 'hour' 
  55. equates. They are both read only and will only be read if 
  56. 'DATE:- ' or 'TIME:- ' is found in the 1st record of the 
  57. file. 
  58.  
  59. As a part of the 'TITLE' line each page of a listing will be 
  60. time stamped. Don't forget enough spaces after time and date 
  61.  
  62. For ported or external clocks, a routine at the begining
  63. would not be beyond the realms of possisbilty.
  64.  
  65. The program may be assembled to run stand alone, but a far
  66. better use, is to patch it to the end of your assembler.
  67. I chose the high memory end of the assembler as only one
  68. address needs to be changed and after it's done it's thing
  69. the assembler will use the space for normal data etc.
  70.  
  71. ORG this program to an address at the end of your assembler, 
  72. assemble it to a COM file and load it using DDT or 
  73. equivalent, next load your assembler.COM in front of this 
  74. program. Then change a jump at the begining of the assembler 
  75. to the ORG value. Save the whole shmozzle as a COM file and 
  76. you will have no further trouble deciding which file/listing 
  77. is current. 
  78.  
  79. This addition is completely 'invisable' to the assembler and
  80. uses no memory space as it is loaded with the assembler in
  81. it's work area.
  82.  
  83. Command examples:
  84. =================
  85.  
  86. a:timestmp b:xyz.rel,lst:=c:xyz.mac m<cr>
  87.  
  88. get this prog. on A, put object on B, prn to printer, source
  89. found on C and this is a major version change.
  90.  
  91. timestmp =xyz<cr>    increment minor version number, date &
  92.               time stamp. assemble xyz.mac, create
  93.               xyz.rel, all on the default disk.
  94.  
  95. timestmp =xyz n<cr>  as above, but leave version number
  96.               unchanged.
  97.  
  98. timestmp =xyz m n<cr>    INVALID (only 1 option allowed)
  99.  
  100. timestmp xyz m<cr>   leave out '=' if stand alone    
  101.  
  102. Source file extention will always default to 'MAC'
  103.  
  104. ******************************************************
  105. *                             *    
  106. * May you never again have six  " CURRENT "  files ! *
  107. *                             *
  108. ******************************************************
  109.  
  110. Eric.
  111.