home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / FS_20.ZIP / FILESTAT.DOC < prev    next >
Text File  |  1994-10-03  |  5KB  |  128 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.               ╓────────────────────────────────────────────────╖
  7.               ║ FILESTAT v2.0  Zip/ARJ File Statistics Utility ║
  8.               ║   For Updating SFFILES.BBS File Descriptions   ║
  9.               ║     Copyright (C) 1993,94 by Kevin Cummins     ║
  10.               ╙────────────────────────────────────────────────╜
  11.  
  12. What It Does:
  13. ─────────────
  14. FILESTAT 'looks' inside each ZIP or ARJ file in a given SF File Area, and
  15. determines the number of files, the oldest, and the newest files in the
  16. archive. It then appends a line something like:
  17.  
  18.         *Files:  5  Oldest-06/07/92  Newest-08/11/92
  19.  
  20. to the end of that file's description in your SFFILES.BBS.
  21.  
  22. Considerations:
  23. ───────────────
  24. NOTICE: FILESTAT v1.6ß2+ will only work on SF 3.5+. It MAY NOT work
  25. correctly on versions of SF prior to 3.5.
  26.  
  27. FILESTAT will not process any file listed other than a .ZIP or .ARJ file.
  28. So, if you are using another archiving method, this utility won't be of
  29. much value to you. (maybe a future version....?)
  30.  
  31.  
  32. Operation:
  33. ──────────
  34. Execution is very simple. If you place FILESTAT somewhere in your dos path,
  35. you can then simply change to the directory you wish to run FILESTAT on,
  36. and type >FILESTAT
  37.  
  38. When run in this manner, FILESTAT will expect to find PKZIP.EXE somewhere
  39. in your path, so make sure it *IS* in your path before execution.
  40.  
  41. If you need or want to specify the location of PKZIP and/or ARJ, FILESTAT
  42. will accept command line parameters. Valid command line parameters are
  43. /ZIP=path to PKZIP.EXE and /ARJ=path to ARJ.EXE. Then, execution could be
  44. by typing something like:
  45.  
  46.  Example: FILESTAT                              Filestat will search your
  47.                                                 path for ZIP/ARJ
  48.  
  49.  Example: FILESTAT /ZIP=C:\UTILS\PKZIP.EXE      Filestat will use specified
  50.                                                 path to PKZIP, and search
  51.                                                 for ARJ in path. If ARJ is
  52.                                                 not found, no big deal.
  53.  
  54.  Example: FILESTAT /ZIP=C:\UTILS\ARJ.EXE        Filestat will use specified
  55.                                                 path to ARJ, and search
  56.                                                 path for PKZIP. NOTE: PKZIP
  57.                                                 must be found somewhere in
  58.                                                 path, or Filestat will
  59.                                                 abort.
  60.  
  61.  Example: FILESTAT /ZIP=C:\UTILS\PKZIP.EXE /ARJ=C:\UTILS\ARJ.EXE
  62.  
  63.                                                 Filestat will use the
  64.                                                 specified paths for both
  65.                                                 PKZIP and ARJ.
  66.  
  67. Which ever method is used for determining the path to PKZIP and/or ARJ,
  68. Filestat WILL verify their actual existence on your system. Remember, PKZIP
  69. *MUST* be on your system for Filestat to run. ARJ, on the other hand, is
  70. entirely optional. If ARJ doesn't exist on your computer, Filestat will run
  71. just fine as long as it finds PKZIP.
  72.  
  73. FILESTAT never writes to your present SFFILES.BBS, for those of you who
  74. become apprehensive about having your file listings messed with. Once
  75. processing is complete, your old file is renamed to SFFILES.BAK and the new
  76. one takes it place.
  77.  
  78. As of this writing, I have tested both PKZIP 1.1 and 2.04g with FILESTAT.
  79. Both seem to work fine, no matter which version the files were actually
  80. zipped with.
  81.  
  82. Suggestions:
  83. ────────────
  84. If you have a temporary 'Recent Upload' directory such as I do, then adding
  85. FILESTAT to run on that directory as a nightly event will have those files
  86. updated before you move them to their permanent file area.
  87.  
  88. If you have problems running Filestat, use the /ZIP= and/or /ARJ=
  89. parameters if you haven't already done so. If you still have problems,
  90. contact the author.
  91.  
  92.  
  93. Registration:
  94. ─────────────
  95. All you need to make this copy registered is a registration file, which
  96. will also be good for any future version of FILESTAT. The Registration fee
  97. is only $5. FILESTAT does not have any features crippled. Registered and
  98. non-registered versions do exactly the same job, the only difference being
  99. the 'Shareware' reminder as the program starts.
  100.  
  101. Creating your registration file only takes a couple seconds, and can be
  102. ready for download on Crimson Cross, usually within 24 hours after
  103. receiving your registration form.
  104.  
  105. A FORM.REG file is included for your convenience.
  106.  
  107.  
  108. Distribution:
  109. ─────────────
  110. FILESTAT is released as Shareware. You are welcome to distribute it freely
  111. in it's unmodified form. You may evaluate for a period of thirty days, and
  112. are then required to register if you continue use it.
  113.  
  114. Thanks:
  115. ───────
  116. Thanks goes to Bob St.Cyr for suggesting, and testing this utility. Bob is
  117. SysOp of the Software Exchange BBS at 717-243-9620 in Carlisle, PA.
  118.  
  119.  
  120.  
  121. Questions or Comments can be directed to Kevin Cummins at:
  122.  
  123.     Crimson Cross BBS                     RIME  Network
  124.       618-253-3608                      Node: #1390 CCBBS
  125.  
  126.  
  127.  
  128.