home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pcjr / arc / TIA101.LZH / TIA101.DOC < prev   
Text File  |  1989-08-29  |  8KB  |  199 lines
  1.  
  2.  
  3.                           Truth In Advertising!
  4.                       True Date Conversion Utility
  5.                             For Archive Files
  6.                         R E V I S I O N   1 . 0 1
  7.  
  8.                          written by Bill Auclair
  9.                     (C) 1989 XanSoft Development, Inc.
  10.                            All Rights Reserved
  11.  
  12.  
  13. NOTICE:
  14.  
  15. This software is offered as Shareware. It may be freely used and
  16. distributed, as long as all files within the package are complete
  17. and unmodified.  If you find this program useful, a contribution
  18. in the amount of $15 may be sent to the author at this address:
  19.  
  20.                          Bill Auclair
  21.                          XanSoft Development, Inc.
  22.                          P.O. Box 3162
  23.                          Danbury, CT 06813
  24.  
  25.  
  26. If this package is used within a corporate or government environment,
  27. the contribution should be considered a requirement.
  28.  
  29.  
  30. Files within this package:
  31.  
  32.            TIA.EXE -    The TIA true date conversion utility.
  33.            TIA101.DOC - The documentation file you're reading now.
  34.  
  35.  
  36.  
  37. DISCLAIMER:
  38.  
  39. Users of this software do so at their own risk.  The author is not
  40. liable for damages of any kind arising from the operation, or failure
  41. to operate, of TIA.  Damages include, but are not limited to, loss or
  42. erasure of any files, archived or unarchived.
  43.  
  44. The following programs are necessary for the proper operation of TIA:
  45.  
  46.                     LHARC.EXE   (C) Haruyasu Yoshizaki
  47.                     ARCE.COM    (C) System Enhancement Associates, Inc.
  48.                     PAK.EXE     (C) NoGate Consulting, Inc.
  49.                     PKZIP.EXE   (C) PKWare, Inc.
  50.                     ZOO.EXE     (C) Rahul Dhesi
  51.  
  52. These programs are not included within this archive.
  53.  
  54.  
  55.  
  56. WHAT IS TIA?
  57.  
  58. Have you ever downloaded or file-requested a file with an interesting
  59. name or description, only to discover after you de-archived it on your
  60. system that it dated back to the "prehistoric" age of personal computing
  61. (pre-1985)?  I have.  That's the main reason why I wrote this utility.
  62.  
  63. TIA will search for archive files with .ARC, .PAK, .ZIP, .ZOO or .LZH
  64. extensions in a subdirectory. When it finds a file meeting its search
  65. criteria, it will de-archive the contents of that file to a user-
  66. specified work directory.  TIA will then examine the datestamps of each
  67. file within the work directory, and attach to the archive file in the
  68. original directory the date stamp of the NEWEST, OLDEST or LARGEST
  69. file within the archive.  Time and date stamp selection criteria are
  70. defined via command-line switches.
  71.  
  72. This means that the date stamp of any archive file processed with
  73. TIA will correspond to the creation date of one or all of the files
  74. contained within the archive, letting downloaders and FREQers know if
  75. they're getting a late-model program or yesterday's news.
  76.  
  77. That's what I call "Truth In Advertising"....
  78.  
  79.  
  80.  
  81.  
  82. WHAT TIA CAN BE USED FOR:
  83.  
  84. TIA.EXE can be used by BBS sysops to perform a "one-shot" conversion to
  85. "true date" archive files.  The program can also be run from a batch
  86. file to periodically convert any new archive files received to a
  87. "true date" status.  TIA may defeat the purpose of certain "new files"
  88. utilities that rely on file datestamps to indicate recent uploads to
  89. a bulletin board system. It's best to experiment to see if this is the
  90. case with your setup.
  91.  
  92.  
  93.  
  94. USING TIA:
  95.  
  96. TIA supports parameter-passing via the command line.  The following
  97. are examples of valid command line syntax:
  98.  
  99.  
  100. TIA                    ---->  No parameters.  Generates a help screen.
  101.  
  102.  
  103. TIA [<workdir><-date switch><hour min sec>]
  104.  
  105.                        ---->  where <workdir> is a user-specified work
  106.                               directory.  If the directory does not
  107.                               exist, TIA will exit with an error
  108.                               message.  IMPORTANT!  The work directory
  109.                               should be empty before TIA is invoked.
  110.                               If any files are in the work directory
  111.                               before TIA is invoked, the program will
  112.                               exit with an error message. If an attempt
  113.                               is made to use the root directory of any
  114.                               drive as a work directory, TIA exits with
  115.                               an error message.  If an attempt is made
  116.                               to use the current directory as a work
  117.                               directory, TIA also exits with an error
  118.                               message.
  119.  
  120.                        ---->  where <-date switch> is one of the
  121.                               following command-line switches:
  122.  
  123.                               -N   Use datestamp of NEWEST file within
  124.                                    the original archive.
  125.  
  126.                               -O   Use datestamp of OLDEST file within
  127.                                    the original archive.
  128.  
  129.                               -L   Use datestamp of LARGEST file within
  130.                                    the original archive.
  131.  
  132.  
  133.                               Use of the LARGEST file (-L) is the
  134.                               default selection, and does not have to be
  135.                               specified on the command line.
  136.  
  137.                        ---->  where <hour min sec> is a user-specified
  138.                               timestamp value to be attached to each
  139.                               processed archive file.  Attachment of
  140.                               this stamp is necessary to avoid
  141.                               re-processing the same archive files
  142.                               each time TIA.EXE is run.  The program
  143.                               will examine each archive file's time
  144.                               stamp and will not process the file if
  145.                               timestamp values match those specified
  146.                               on the command line.  There is a VERY
  147.                               slim chance (1 in 43200) that an un-
  148.                               processed archive file will have the
  149.                               same time stamp as that specified on the
  150.                               command line, but with those kind of
  151.                               odds, it's not much to worry about.
  152.                               The default time stamp is 11:28:58, which
  153.                               does not have to be entered on the
  154.                               command line. 11/28/58 happens to be my
  155.                               birthdate, by the way (hint hint).
  156.  
  157.                       NOTE:   Time stamp resolution is 2 seconds,
  158.                               which means that if you want to re-
  159.                               process files for any reason, you'll
  160.                               have to change the time stamp value
  161.                               originally specified on the command
  162.                               line by at least 2 seconds.
  163.  
  164.  
  165.  
  166. INSTALLATION STEPS:
  167.  
  168. 1. Install TIA.EXE in the DOS subdirectory of your choice. Make sure
  169.    the directory is included in your DOS path.
  170.  
  171. 2. ALL of the following programs must be available within your DOS path:
  172.  
  173.                 LHARC<tm>    by Haruyasu Yoshizaki
  174.                 ARCE<tm>     from System Enhancement Associates
  175.                 PAK<tm>      from NoGate Consulting, Inc.
  176.                 PKUNZIP<tm>  from PKWare, Inc.
  177.                 ZOO<tm>      by Rahul Dhesi
  178.  
  179.  
  180.  
  181.  
  182. REVISION HISTORY:
  183.  
  184. 5/5/89:   Version 1.00-- first public release of TIA.
  185.  
  186. 7/1/89:   Version 1.01-- got rid of a few nasty bugs, including one
  187.           which caused TIA to generate strange date stamps on archive
  188.           files unable to be processed correctly (bad archive, etc.)
  189.           Thanks to Don Dawson of 1:141/730 for his debugging efforts.
  190.  
  191.  
  192.  
  193. Please send all compliments, criticism, advice and bug reports to:
  194.  
  195.                         Bill Auclair
  196.                         Xanadu BBS
  197.                         Opus/Fido Node 1:141/545.0
  198.  
  199.