home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / STAMP111.ZIP / STAMP.DOC < prev    next >
Text File  |  1993-04-13  |  13KB  |  292 lines
  1.                        ████████████████████
  2.                        ██                ██
  3.                        ██    STAMPER     ██
  4.                        ██                ██
  5.                        ██  Version 1.11  ██
  6.                        ██                ██
  7.                        ████████████████████
  8.  
  9. ┌───────────────────────────────────────────────────────────────┐
  10. │ GENERAL                                                       │
  11. └───────────────────────────────────────────────────────────────┘
  12.  
  13.     This program sets file date-time stamps.  To use it, enter
  14.  
  15.  
  16.          STAMP filespec [date] [time]
  17.  
  18.  
  19. Arguments in brackets are optional.  
  20.  
  21.     Enter dates in the format mm-dd-yy, and times as hh:mm:ss (24 
  22. hour clock).  If you don't give them, the date and time default 
  23. to the current date & time.  STAMPER won't change the date-time 
  24. stamps on directories, or hidden or read only files.   It will 
  25. beep and show an error message if you try to do so. 
  26.  
  27. ┌───────────────────────────────────────────────────────────────┐
  28. │ EXAMPLES                                                      │
  29. └───────────────────────────────────────────────────────────────┘
  30.  
  31.  
  32.          STAMP *.*
  33.  
  34.  
  35. sets date-time stamp of all files in the current directory on the 
  36. default drive to the current date and time.  
  37.  
  38.  
  39.          STAMP *.EXE 10-13-89 12:00
  40.  
  41.  
  42. Sets the date time stamp for all EXE files to noon on 13 Oct 
  43. 1989. 
  44.  
  45. ┌───────────────────────────────────────────────────────────────┐
  46. │ APPLICATIONS                                                  │
  47. └───────────────────────────────────────────────────────────────┘
  48.  
  49.     File Management:  STAMPER is especially handy when backing up 
  50. hard disks with software that relies on date time stamps.  You 
  51. can use it to affect which files get backed up.
  52.  
  53.     Programming:  STAMPER is useful in projects which use MAKE 
  54. utilities.  Since MAKE programs often rely on file date-time 
  55. stamps to find out which object modules need updating, you can 
  56. use STAMPER to manually tweak the system. 
  57.  
  58.     Users are invited to tell the author what other uses they 
  59. find for STAMPER. 
  60.  
  61. ┌───────────────────────────────────────────────────────────────┐
  62. │ SYSTEM REQUIREMENTS                                           │
  63. └───────────────────────────────────────────────────────────────┘
  64.  
  65.     STAMPER requires MS-DOS or PC-DOS, version 2.0 or later.
  66.  
  67. ┌───────────────────────────────────────────────────────────────┐
  68. │ EXIT CODES                                                    │
  69. └───────────────────────────────────────────────────────────────┘
  70.  
  71.     STAMPER reports the following exit codes.  You can use these 
  72. with the ERRORLEVEL function in batch files (see your DOS manual 
  73. for details). 
  74.  
  75.     0  Normal termination
  76.     2  Error occurred
  77.  
  78. ┌───────────────────────────────────────────────────────────────┐ 
  79. │ WHAT'S IN THIS PACKAGE                                        │
  80. └───────────────────────────────────────────────────────────────┘
  81.  
  82.     This package contains the following files:
  83.  
  84.     STAMP.EXE     Main program
  85.     STAMP.DOC     Documentation
  86.     REGISTER.DOC  Registration form
  87.     VENDOR.DOC    Catalog of other software available
  88.     FILE_ID.DIZ   For use by electronic bulletin boards
  89.  
  90. ┌───────────────────────────────────────────────────────────────┐
  91. │ REVISION HISTORY                                              │
  92. └───────────────────────────────────────────────────────────────┘
  93.  
  94. 1.00   Original version
  95. 1.10   Fixed date setting bug
  96.        Added capability to stamp files in other directories/drives
  97. 1.11   Made program shareware
  98.  
  99. ┌───────────────────────────────────────────────────────────────┐
  100. │ MESSAGES                                                      │
  101. └───────────────────────────────────────────────────────────────┘
  102.  
  103. Couldn't set date-time.  Perhaps the file is read only? 
  104.  
  105. Date-time reset.  Success!
  106.  
  107. Floating point not loaded.  This may be a compiler error.  Please 
  108. contact the author and describe the circumstances in which this 
  109. message appeared. 
  110.  
  111. Integer divide by 0.  This may be a compiler error.  Please 
  112. contact the author and describe the circumstances in which this 
  113. message appeared. 
  114.  
  115. No file(s) found.  STAMPER found no files meeting your 
  116. specification. 
  117.  
  118. Not enough space for environment.  This may be a compiler error.  
  119. Please contact the author and describe the circumstances in which 
  120. this message appeared. 
  121.  
  122. Stack overflow.  This may be a compiler error.  Please contact 
  123. the author and describe the circumstances in which this message 
  124. appeared. 
  125.  
  126. ┌───────────────────────────────────────────────────────────────┐ 
  127. │ CREDITS                                                       │
  128. └───────────────────────────────────────────────────────────────┘
  129.  
  130.     STAMPER was written in C by Richard W. Adams.  It was 
  131. developed with PC-Write, version 3.02, & the Microsoft C 
  132. Optimizing Compiler, version 5.1. 
  133.  
  134.     The author is a member of the Association of Shareware 
  135. Professionals (ASP).  You may reach him at the address given in 
  136. REGISTER.DOC.  Should that address no longer be valid, try 
  137. contacting him through the ASP (545 Grover Road, Muskegon, MI 
  138. 49442).
  139.  
  140. ┌───────────────────────────────────────────────────────────────┐ 
  141. │ REGISTRATION                                                  │
  142. └───────────────────────────────────────────────────────────────┘
  143.  
  144.     STAMPER is copyright 1991 by Richard W. Adams, all rights 
  145. reserved.  The program is "shareware."  If you use STAMPER for 
  146. more than 30 days, you must register.  To do so, complete the 
  147. registration form in REGISTER.DOC & send it with a check for the 
  148. indicated amount to the author at the address on the form. 
  149.  
  150. When you register, you receive:
  151.  
  152.     o The right to use your copy of Except on a single computer
  153.  
  154.     o FREE technical support by mail for three months
  155.  
  156.     o Eligibility for FREE copies of future versions if you're 
  157.       the first to suggest improvements or report bugs that are 
  158.       fixed/incorporated in future versions
  159.  
  160.     o A DISCOUNT if you subscribe to Shareware Magazine
  161.  
  162.    Not only is registration a legal & ethical requirement, but 
  163. registration fees give shareware authors the incentive to develop 
  164. new software & improve old ones. 
  165.  
  166.     Tax exempt Christian religious organizations & churches are 
  167. eligible for free registration of STAMPER for official business.  
  168. Send a written request to the author, & you'll receive 
  169. registration forms.  The registration takes effect when you 
  170. complete return the forms.  This is a charitable donation. 
  171.  
  172.     Companies, government agencies & other organizations may 
  173. obtain site licenses for STAMPER, at greatly reduced unit costs.  
  174. Contact the author for details & a price list. 
  175.  
  176. ┌───────────────────────────────────────────────────────────────┐ 
  177. │ SHAREWARE                                                     │ 
  178. └───────────────────────────────────────────────────────────────┘ 
  179.  
  180.     Shareware distribution gives users a chance to try software 
  181. before buying it. If you try a Shareware program and continue 
  182. using it, you are expected to register.  Individual programs 
  183. differ on details--some request registration, others require it, 
  184. and some specify a maximum trial period.  With registration, you 
  185. get anything from the simple right to continue using the software 
  186. to an updated program with printed manual. 
  187.  
  188.     Copyright laws apply to both Shareware and commercial 
  189. software, and the copyright holder retains all rights, with a few 
  190. specific exceptions as stated below.  Shareware authors are 
  191. accomplished programmers, just like commercial authors, and the 
  192. programs are of comparable quality. (In both cases, there are 
  193. good programs and bad ones!)  The main difference is in the 
  194. method of distribution.  The author specifically grants the right 
  195. to copy and distribute the software, either to all and sundry or 
  196. to a specific group.  For example, some authors require written 
  197. permission before a commercial disk vendor may copy their 
  198. Shareware. 
  199.  
  200.     Shareware is a distribution method, not a type of software. 
  201. You should find software that suits your needs and pocketbook, 
  202. whether it's commercial or Shareware. The Shareware system makes 
  203. fitting your needs easier, because you can try before you buy. 
  204. And because the overhead is low, prices are low also. Shareware 
  205. has the ultimate money-back guarantee--if you don't use the 
  206. product, you don't pay for it. 
  207.  
  208. DISCLAIMER - AGREEMENT 
  209.  
  210.     Users of STAMPER must accept this disclaimer of warranty: 
  211. "STAMPER is supplied as is.  The author disclaims all warranties, 
  212. expressed or implied, including, without limitation, the 
  213. warranties of merchantability and of fitness for any purpose. The 
  214. author assumes no liability for damages, direct or consequential, 
  215. which may result from the use of STAMPER." 
  216.  
  217.     STAMPER is a Shareware program and is provided at no charge 
  218. for your evaluation.  Feel free to share it with your friends, 
  219. but please don't give it away altered or as part of another 
  220. system.  The essence of "user-supported" software is to provide 
  221. personal computer users with quality software without high 
  222. prices, and yet to provide incentive for programmers to continue 
  223. to develop new products.  If you find STAMPER useful and continue 
  224. to use it after a reasonable trial period, you must make a 
  225. registration payment of $5.00 to the author.  The $5.00 
  226. registration fee will license one copy for use on any one 
  227. computer at any one time.  You must treat this software just like 
  228. a book.  An example is that any number of people may use this 
  229. software and may freely move it from one computer location to 
  230. another, so long as there is no possibility of it being used at 
  231. one location while it's being used at another.  Just as two 
  232. different people can't read a book at the same time. 
  233.  
  234.     Commercial users of STAMPER must register and pay for their 
  235. copies of STAMPER within 30 days of first use or their license is 
  236. withdrawn.  Site-License arrangements may be made by contacting 
  237. the author. 
  238.  
  239.     Anyone distributing STAMPER for any kind of remuneration must 
  240. first contact the author for authorization. This authorization 
  241. will be automatically granted to distributors recognized by the 
  242. (ASP) as adhering to its guidelines for shareware distributors, 
  243. and such distributors may begin offering STAMPER immediately. 
  244. (However, you must still advise the author so the distributor can 
  245. be kept up-to-date with the latest version of STAMPER.) 
  246.  
  247.     You are encouraged to pass a copy of STAMPER to your friends 
  248. for evaluation.  Please encourage them to register their copy if 
  249. they find that they can use it. 
  250.  
  251. ┌───────────────────────────────────────────────────────────────┐ 
  252. │ COPYING                                                       │ 
  253. └───────────────────────────────────────────────────────────────┘ 
  254.  
  255. You may copy & distribute STAMPER freely, as long as you: 
  256.  
  257.     o Include all constituent files.
  258.  
  259.     o Don't change the software or documentation.
  260.  
  261.     o Don't distribute the program for commercial purposes 
  262.       without written permission from the author. 
  263.  
  264.     o Don't rent or lease it.
  265.  
  266.     o Charge no fee other than a nominal one to cover distribution 
  267.       costs.
  268.  
  269. ┌───────────────────────────────────────────────────────────────┐ 
  270. │ OMBUDSMAN                                                     │ 
  271. └───────────────────────────────────────────────────────────────┘ 
  272.  
  273.     The author is a member of the Association of Shareware 
  274. Professionals (ASP).  ASP wants to make sure that the shareware 
  275. principle works for you. If you can't resolve a shareware related 
  276. problem with an ASP member by contacting the member directly, ASP 
  277. may be able to help.  The ASP Ombudsman can help you resolve a 
  278. dispute or problem with an ASP member, but does not provide 
  279. technical support for members' products.  Please write to the ASP 
  280. Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a 
  281. CompuServe mail message to the ASP Ombudsman (70007,3536). 
  282.  
  283.                        _______
  284.                   ____|__     |                (R)
  285.                --|       |    |-------------------
  286.                  |   ____|__  |  Association of
  287.                  |  |       |_|  Shareware
  288.                  |__|   o   |    Professionals
  289.                -----|   |   |---------------------
  290.                     |___|___|    MEMBER
  291.  
  292.