home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BBSCAN20.ZIP / BBSCAN.DOC next >
Encoding:
Text File  |  1993-10-01  |  6.0 KB  |  141 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 BBSCAN Ver 2.0
  6.                             (c) 1993 by Terry Huss
  7.  
  8.  
  9.  
  10.  
  11. What is BBSCAN?
  12.  
  13.      BBSCAN is an offline filelist search utility for Computer enthusiasts.
  14. It has the ability to search through most filelists generated by Bulletin
  15. Board Systems or CD Rom doors. BBSCAN creates an output of results to the
  16. screen and/or file which contains the file name and full description from
  17. the original listing. BBSCAN also has the addtional feature of doing AND,
  18. OR and NOT logical searches with on-screen highlighting of search keywords.
  19.  
  20. How Do I Use BBSCAN?
  21.  
  22.      BBSCAN is easy to use. The simplest way to start using BBSCAN is to
  23. type "BBSCAN" at the command-line prompt. The program will then prompt you
  24. for the filelisting name which can be any filelisting that has the filename
  25. and extension as the first part of the description.  This is what BBSCAN uses
  26. for its search and most, if not all filelistings use this format as it seems
  27. logical to show the filename before the rest of the information.
  28.  
  29.      Next the program will prompt you for the text for which you wish to
  30. search for.  You can enter either a keyword with no embedded spaces, such as
  31. "game" or "utility". Note that the quotes are not necessary for single words.
  32. However you may want to search for a sentence or partial phrase such as
  33. "utility for dos" or "action packed game".   This is where the need for
  34. quotes is a must.
  35.  
  36. Command Line Use:
  37.  
  38.     Useage : BBSCAN source ["]text1["] [/A|/O|/N ["]text2["]]
  39.  
  40.       source        Path and name of BBS or CDROM filelist to search.
  41.       "             Proceeds and follows search string(s) containing spaces.
  42.       text          Word or "string" to search source file for.
  43.       /A            Perform logical AND searches
  44.       /O            Perform logical OR searches
  45.       /N            Perform logical NOT searches
  46.       text2         Second word or "string" for logical searches only
  47.     Type BBSCAN/? for this help screen
  48.  
  49. source: Any BBS or CDROM filelisting which contains as its first field
  50.         a file name with an extension, followed by a description of the
  51.     file. The description can be a single line, a double line sep-
  52.     arated by spaces or a multiple line description or a filelist
  53.     which uses a combination of all three description formats.
  54.  
  55. "     : Strings or groups of words you wish to search for must be enclosed
  56.         in quotes. This is true only if the search words are separated by
  57.         spaces. Otherwise the quotes may be omitted.
  58.  
  59. text1  : This is the keyword or "string" that you wish to search for.
  60.  
  61. text2  : This is the second keyword or "string" for performing logical
  62.          searches only. It is always separated from text1 by one of the
  63.          logical switches listed below:
  64.  
  65. Logical Switches:
  66.  
  67. /A    : Will instruct BBSCAN to search for an occurance anywhere in the
  68.         filelist's descriptions for text1 AND text2.
  69.  
  70. /N    : Will instruct BBSCAN to search for an occurance anywhere in the
  71.         filelist's descriptions for text1 BUT NOT text2.
  72.  
  73. /O    : Will instruct BBSCAN to search for an occurance anywhere in the
  74.         filelist's descriptions for text1 OR text2.
  75.  
  76. NOTE: All logical switches must be separated from text1 and text2 by a
  77.       space.
  78.  
  79. For example:
  80.               BBSCAN *.lst "good book" /o "fine reading"
  81.  
  82. Will search: All filelists with a .LST extension for the occur-
  83.              ances of "good book" OR "fine reading" and show the results
  84.              on-screen.
  85.  
  86.     BBSCAN is not case-sensitive. Therefore a search for "ADVENTURE GAME"
  87. will find every occurance of the phrase "adventure game" whether it is
  88. uppercase, lowercase or mixed-case. This can be handy since you never
  89. know how the description was entered by the person who uploaded the file.
  90.  
  91. Additional Features:
  92.  
  93.    BBSCAN will NOT search *.EXE, *.COM, or *.BAT files. It does accept
  94. wildcards for source file names. If you use *.* for your source file
  95. parameter then BBSCAN will search every file in the designated directory
  96. except for those mentioned above. For best results, keep all your file-
  97. lists in a separate directory from your other programs.
  98.  
  99.    You may abort the search at anytime by pressing the ESCAPE key. Also,
  100. when asked a yes/no question by BBSCAN the Escape key is regarded the
  101. same as pressing 'n'.  The default filename for the saved file is
  102. BBSCAN.RPT.  This is handy if you don't want to clutter up your drive
  103. with a lot of extra filelists. Otherwise you can enter a filename of your
  104. choosing when BBSCAN prompts you to do so.
  105.  
  106. Credits:
  107.  
  108.     Thanks go out to Walt Miller and Bob Hammes for testing and assisting
  109. in writing this version of BBSCAN. Also, thanks to all the folks on the
  110. PASCAL Echo who helped either directly or indirectly through their comments
  111. and/or source code examples.  Also to the SWAG group for their compilation
  112. of source code and information which has proved helpful in times of crisis.
  113.  
  114. Limitations:
  115.  
  116.     This software has not been tested on ALL computers. If you experience
  117. an incompatiblity problem you can contact the author via the Postal Service
  118. at the address given below.  I believe this will work well on most IBM-
  119. compatible computers. However, there may be an unforseen compatibility
  120. problem which I would attempt to correct if I am made aware of it. I am
  121. making no warranties what-so-ever of its fitness for a particular computer
  122. or use. Like the saying goes "TRY before you BUY".  In other words, if you
  123. don't like it then don't buy it. Otherwise: <grin> read on...
  124.  
  125. Registration:
  126.  
  127.     If you find this program useful and would like to see future releases
  128. developed with even more features, you can register your copy of BBSCAN
  129. for only $9.95.
  130.  
  131.     Registered users will receive: The latest version of BBSCAN along with
  132. TSCAN, a file viewer and keyword highlighter designed for use with BBSCAN
  133. generated filelists.
  134.  
  135. Send orders To:
  136.     Terry Huss
  137.         P.O. Box #75
  138.         Winchester, Kansas 66097-0075
  139.  
  140.    Please specify whether you would like a 3.5" or 5 1/4" disk.
  141.