home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / ufo11.arj / UFO.DOC < prev    next >
Text File  |  1992-07-12  |  10KB  |  189 lines
  1.  
  2. ╓─────────────────────────────────────────────────────────────────────────╖
  3. ║                  Unwanted File Organizer Version 1.1                    ║
  4. ║               Copyright (c) 1992 by Clayton & Associates                ║
  5. ║                           All Rights Reserved                           ║
  6. ╟─────────────────────────────────────────────────────────────────────────╢
  7. ║                    Released: Sunday, July 4th, 1992.                    ║
  8. ║ **Please scan files for viruses before use!  Just a safety precaution** ║
  9. ╙─────────────────────────────────────────────────────────────────────────╜
  10.  
  11. ╓─────────────────────────────────────────────────────────────────────────╖
  12. ║ UFO Disclaimer and Registration Information                             ║
  13. ╙─────────────────────────────────────────────────────────────────────────╜
  14.  
  15. UFO is provided on an "as is" basis, without any warranty of any kind.
  16. We, at Clayton & Associates, do not warrant, guarantee or make any
  17. representations regarding the use of, or the results of UFO.  We are also,
  18. in no way possible, responsible for any damages sustained either directly,
  19. or indirectly from the use of UFO.
  20.  
  21. A registration form is included in this package.  You are required to
  22. register this after 31 days of use.  This is a shareware product, but please
  23. support the shareware aspect.  Registration is only $5.00 so we are not
  24. asking alot.  There have many late nights spent writing UFO and this way we
  25. know our program is being appreciated.
  26.  
  27. When you run UFO, there will be a number displayed in the lower window on
  28. the screen.  It is labeled as a PreRegistration number.  When and if you
  29. decide to register your copy of UFO with us, please remember to include this
  30. number with your registration fee as this number is required by us to create
  31. your keyfile.
  32.  
  33. ╓─────────────────────────────────────────────────────────────────────────╖
  34. ║ What is UFO you say?                                                    ║
  35. ╙─────────────────────────────────────────────────────────────────────────╜
  36.  
  37. UFO will perform three operations on  your "FILES.BBS" file in each of your
  38. download sub-directories:
  39.  
  40. 1.      UFO will check to see if a download counter and/or download
  41.         description is present and if not, one of the following
  42.         will added:
  43.  
  44.         a)  <0> Description not available
  45.         b)  [0] Description not available
  46.         c)  (0) Description not available
  47.         d)  {0} Description not available
  48.  
  49.         One of the four choices above is available for selection through the
  50.         configuration file.  The choice you make is of GREAT importance and
  51.         must match the selection you chose in your SuperBBS configuration
  52.         file.  If select the wrong one, your "FILES.BBS" could be rewritten
  53.         with erroneous file descriptions.
  54.  
  55. 2.      UFO will create a file called "DEADFILE.LST" in each of your download
  56.         sub-directories.  This file contains the name and extension of each
  57.         file whose download counter shows zero.
  58.  
  59. 3.      Lastly, UFO will recreate your "FILES.BBS" with a nice clean layout.
  60.         It has been found that some "FILES.BBS" files we tested with did not
  61.         have all the download counters placed at the 14th column in the file.
  62.         UFO will correct this and rewrite the file for you.
  63.  
  64. Operations 1 and 3 are selectable in one way or another and is controlled via
  65. the configuration file which is described below.
  66.  
  67. ╓─────────────────────────────────────────────────────────────────────────╖
  68. ║ Configuration File for UFO                                              ║
  69. ╙─────────────────────────────────────────────────────────────────────────╜
  70.  
  71.  
  72. A sample configuration file is shown below for your viewings.  UFO requires
  73. a configuration file by the name of "UFO.CFG" and will not run without this
  74. file.  This file MUST also be located in the same directory that the
  75. "UFO.EXE" file is located in.  You can create this with MS-DOS's Edlin or 
  76. any other ASCII Editor.  All lines will be described as to what they do in
  77. the example below:
  78.  
  79.   Line 1:  What style brackets you have chosen for SuperBBS
  80.  
  81.            Your choices are as follows:
  82.  
  83.            1 - <>       2 - []       3 - ()       4 - {}
  84.  
  85.            IT IS EXTREMELY IMPORTANT THAT YOU CHOOSE THE RIGHT ONE!!
  86.            ERRORS BEYOND OUR CONTROL MAY AND PROBABLY WILL RESULT
  87.            FROM AN INCORRECT SELECTION!!
  88.  
  89.   Line 2:  Whether you wish UFO to restructure your "FILES.BBS" file for
  90.            you to give your file listings a nice clean appearance.
  91.  
  92. All following lines are to contain the path to each one of your download 
  93. sub-directories that you wish processed.  The paths you enter do not have
  94. to end with a "\" or begin with a drive letter.  If no "\" is found one
  95. will be appended to it and if no drive letter is present the current drive
  96. will be assumed.  Each one of these sub-directories must contain a
  97. "FILES.BBS" file.  If one is not found or an invalid path is entered, UFO
  98. will skip that path and continue with the next one listed.
  99.  
  100. Please note!!
  101.         The unregistered version will process a maximum of FIVE (5)
  102.         sub-directories.  If you enter more, they will be skipped.  Upon
  103.         registration, UFO will continue with any others that are listed.
  104.         This was done so that you may enter in all you directories now,
  105.         try UFO out, and upon registration, be able to process all you
  106.         directories without having to rewrite your configuration file.
  107.         One thing to remember though is that there is a maximum of 100
  108.         sub-directories that may be processed.  Any others after this
  109.         will be automatically ignored.
  110.  
  111. EXAMPLE CONFIGURATION FILE          This column is for info only.
  112.  
  113.         1                           ; Use <> style brackets
  114.         Y                           ; Restructure all "FILES.BBS" files
  115.         C:\SUPERBBS\FILES\DOS       ; These lines and all others below
  116.         D:\SUPERBBS\FILES\GIF\      ; contain the paths to the sub
  117.         \SUPERBBS\FILES\UTILITYS    ; directories to be processed
  118.  
  119. ╓─────────────────────────────────────────────────────────────────────────╖
  120. ║ Running UFO On your SuperBBS System                                     ║
  121. ╙─────────────────────────────────────────────────────────────────────────╜
  122.  
  123. This is as easy as 1-2-3.  First, copy UFO.EXE into a directory.  Second,
  124. create your configuration file (UFO.CFG).  Third, either execute UFO from
  125. the DOS command line or place it into one of your event batch files.
  126. Remember that the configuration file MUST reside in the same directory as
  127. the UFO.EXE program.
  128.  
  129. UFO can ONLY be run on a SuperBBS system.  It will work with others if
  130. they store their file listings in the same format as SuperBBS does and
  131. the file is named "FILES.BBS".
  132.  
  133. UFO has been tested but may still contain some problems that we do not
  134. know about as of just yet.  If you find find a bug, have an idea of some
  135. feature you would like added, or an idea of something you think should
  136. be changed, feel free to let us know and we will look into it.  If we
  137. receive an idea that we incorporate into UFO, we will be sure to give
  138. you an honourable mention in this documentation and will send you a copy
  139. of the latest version when released.
  140.  
  141. ╓─────────────────────────────────────────────────────────────────────────╖
  142. ║ Other Information and the History of UFO                                ║
  143. ╙─────────────────────────────────────────────────────────────────────────╜
  144.  
  145.  
  146. Version 1.0ß -     Written in Quick Basic 4.5 and released to a few select
  147.                    SuperBBS Sysops for testing.  Initial testing was performed
  148.                    on Air Waves SuperBBS with the help of the Sysop 'Cal
  149.                    Gardner' who, YES, as most of us know is the author of
  150.                    "The Quote Of The Day" (TQOTD). (Great program).  He was
  151.                    a great help and inspiration to get me to write this
  152.                    program.  Thanks Cal!
  153.  
  154. Version 1.1  -     Released to the general public after minor bug found in
  155.                    1.0 with the way it handles non-existent download
  156.                    directories specified in the config file.  Also found
  157.                    the final totals were calculated incorrectly.
  158.  
  159.  
  160. If you have any questions pertaining to UFO or any other inquiries, you
  161. contact me via the following:
  162.  
  163. Company:                             BBS:
  164. Clayton & Associates                 Air Waves SuperBBS HST
  165. Clayton Mattatall                    1200-9600 Bps/HST/MNP
  166. 92 Green Maple Drive                 (416) 984-4076
  167. St. Catharines, Ontario              FidoNet: 1:247/117
  168. CANADA       L2P 3P5                 SIGnet: 34:4416/0
  169.  
  170. ╓─────────────────────────────────────────────────────────────────────────╖
  171. ║ UFO Support Systems                                                     ║
  172. ╙─────────────────────────────────────────────────────────────────────────╜
  173.  
  174. Canada:
  175.  
  176. Air Waves SuperBBS HST      St. Catharines, ON, Canada      +1-416-984-4076
  177.   USR 9600 Bps                FidoNet 1:247/117
  178.  
  179.  
  180. Clayton & Associates has made every effort to supply trademark information
  181. about company names, products and services mentioned in this documentation.
  182. Clayton & Associates cannot attest to the accuracy of this information.
  183.  
  184. EDLIN and MS-DOS are registered trademarks of Microsoft Corporation.
  185.  
  186. SuperBBS is copyright by Aki Antman
  187.  
  188. "The Quote Of The Day" is copyright by Cal Gardner
  189.