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 / CPM / PROGRAMS / CLOCKK / LB-TSTP1.LBR / TIMESTMP.DZC / TIMESTMP.DOC
Text File  |  2000-06-30  |  3KB  |  92 lines
  1. Time stamp   VERS:- 01.01  DATE:- 01/07/88  TIME:- 18:54:00
  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. *    Customized for AMPRO LB (Z80) computers by
  20. *        Larry Sonderling
  21. *        January 7, 1988
  22. *
  23. *************************************************************
  24. Copyright (c) 1982, E. Forbes; permission granted to use,
  25. copy and distribute for non-commercial purposes.
  26.  
  27.  
  28. This version of the program is written to run as a stand alone COM
  29. file.  It has been customized for the AMPRO LB (Z-80) computer
  30. for those who do not have a hardware real-time clock such
  31. as the Kenmore Technologies Z-Time, or SmartClock.
  32.  
  33. Each time a file is edited or assembled the version number can be
  34. incremented and the current date and time will be inserted 
  35. into the first record of the file.
  36.  
  37. This program loads the 1st record from a file and then looks 
  38. for 'VERS:- ', 'DATE:- ' and 'TIME:- ' When it finds any of 
  39. the three it will update ONLY that data. Each entry MUST be 
  40. exactly as shown, upper case characters, colon, minus and 
  41. space all with the high bit off. After updating, it writes 
  42. the modified record back to disk to the same place.
  43.  
  44. When creating a new text file, insert 'VERS:- 00.00' and this 
  45. program will increment the minor number each time you run it 
  46. If the option 'M' is used, the major number will be incre- 
  47. mented and the minor zeroed. If the 'N' option is used, the 
  48. version number will be unchanged. 'M' and 'N' are mutually 
  49. exclusive. 
  50.  
  51. To use the 'DATE:- ' and 'TIME:- ' functions, this program
  52. expects to find three consecutive bytes at MONTH and HOUR,
  53. in BCD format. E.G. to print the date 07/31/82, the bytes
  54. 07H 31H 82H should be available at MONTH, MONTH+1, and
  55. MONTH2. This version, which has been customized for the
  56. AMPRO LB (Z-80) computers requires BIOS version 3.6 or higher,
  57. and the presence of the CTC software clock option, plus the
  58. correct jumpers enabling to enable its operation as detailed
  59. in the AMPRO hardware reference manual.
  60.  
  61. If you do not have a CTC clock ignore, the 'month' and 'hour'
  62. equates. They are both read-only and will only be read if 
  63. 'DATE:- ' or 'TIME:- ' is found in the 1st record of the 
  64. file. 
  65.  
  66. As a part of the 'TITLE' line each page of a listing will be 
  67. time stamped. Don't forget enough spaces after time and date.
  68.  
  69. Command examples:
  70. =================
  71.  
  72. timestmp  xyz<cr>    increment minor version number, date &
  73.               time stamp. 
  74.  
  75. timestmp  xyz n<cr>  as above, but leave version number
  76.               unchanged.
  77.  
  78. timestmp  xyz m n<cr>    INVALID (only 1 option allowed)
  79.  
  80. Source file extension will always default to 'Z80' if not
  81. otherwise specified.
  82.  
  83. ******************************************************
  84. *                             *    
  85. * May you never again have six  " CURRENT "  files ! *
  86. *                             *
  87. ******************************************************
  88.  
  89. Eric.
  90.  
  91. Revised by: Larry Sonderling   January 7, 1988
  92.