home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FINDER10.ZIP / FINDER.DOC < prev    next >
Encoding:
Text File  |  1995-12-17  |  13.1 KB  |  319 lines
  1.  
  2.  
  3.                        ============================
  4.                                  Finder!
  5.                        ============================
  6.                COPYRIGHT 1995 T&J Software & Parole Software
  7.                        COPYRIGHT 1995 NMS Software
  8.  
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.                UltraBBS, Telegard, TriBBS, and Remote Access.
  11.  
  12.                     VERSION 1.00     December 16, 1995
  13.  
  14.                                    By
  15.  
  16.    Tom & Jane Wildoner                   Dennis Maidon
  17.    397 West Broadway                     9411 Buffalo Rd
  18.    Jim Thorpe, PA 18229                  Clayton, NC 27520
  19.    VOICE (717)325-9480                   VOICE (919)965-3600
  20.    *between 6:00 & 8:00 p.m.             *between 4:00 & 8:00 p.m.
  21.       Eastern Time                          Eastern Time Weekdays
  22.    The T&J Software BBS                  The PAROLE Board
  23.    (717)325-9481 - 3 Nodes               (919)965-4696 - 2 Nodes
  24.    tjsoft@postoffice.ptd.net             dmaidon@cris.com
  25.    FIDO 1:268/400                        FIDO 1:151/185
  26.    ftp europa.com                        http://www.cris.com/~dmaidon
  27.        /outgoing/DOORS/tj-software       ftp europa.com
  28.                                              /outgoing/DOORS/parole
  29.                                          ftp ftp.ids.net
  30.                                              /Wildcat/parole
  31.  
  32. LATEST VERSION:
  33. ~~~~~~~~~~~~~~~
  34. Please call the T&J BBS for the latest version of this program.
  35.  
  36.  
  37. LEGALITIES:
  38. ~~~~~~~~~~~
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  41. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  42. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  43. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  44. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  45. DISTRIBUTION OF THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
  46. VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  47. A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  48.  
  49. DISTRIBUTION:
  50. ~~~~~~~~~~~~~
  51. You may make this file available for downloading from your BBS or you may
  52. upload it to any BBS of your choice, provided that you do not make any
  53. changes to the contents of the archive (ZIP file). The archive and its
  54. individual contents may not be used by any service that charges any money
  55. whatsoever, without the written permission of the author.
  56.  
  57. PROGRAM DESCRIPTION:
  58. ~~~~~~~~~~~~~~~~~~~~
  59. Finder! is designed for users wishing to search text files online. Finder!
  60. will search entire subdirectories of your choice, for articles matching
  61. the user's specifications.
  62.  
  63. A Brief Setup Description:
  64.  
  65. First, setup you FINDER.CFG file - see the upcoming section on this. Then,
  66. setup a NODEx.CFG file for each node (the x represents the node number).
  67. The NODEx.CFG is the setup configuration file for using DSZ or GSZ so your
  68. users can download matched text files.
  69.  
  70. You are now ready to setup the MENU.CFG file. This file points to specific
  71. subdirectory's on your system which will contain raw text files. Let's
  72. say the first entry in the this will be computer related text files of
  73. interest. Line 1 would look like this:
  74.  
  75. "Computer Related Text Files","C:\TEXT\COMPUTER"
  76.  
  77. The first item represents the description of the subdirectory (limit
  78. this to 70 characters) and the second item is the path to the subdirectory
  79. (don't include a trailing backslash).
  80.  
  81. All you have to do is literally throw all your computer related text
  82. files into the directory C:\TEXT\COMPUTER - Finder! will take care of the
  83. rest.
  84.  
  85. Your user will be told how many text files are in the directory they
  86. choose. They will be prompted for their keyword to search file followed
  87. by AND/OR/QUIT and then a second keyword. They may also search the
  88. text files by the filedate associated with each file. A bar graph will
  89. appear showing the status of the search and how many matches were
  90. found.
  91.  
  92. Afterwards, they are prompted if they would like the matched text
  93. files archived (Zip) for download.
  94.  
  95. TEXT FILES:
  96. ~~~~~~~~~~~
  97. T&J Software will maintain a file area with text files for Finder! in
  98. FILE AREA 11 on our BBS. Simply call in and download them at
  99. 717-325-9481. You will have access on your first call. You may logon
  100. like this when asked for your logon name:
  101.  
  102. *FINDER TEXT NOW
  103.  
  104. To bypass the logon screens for immediate access. Please note, limited
  105. access will be provided, this is for logging into the BBS to obtain
  106. text files for Finder! only.
  107.  
  108. NOTE:
  109. ~~~~~
  110. When you register, you will receive a file called FINDER.KEY. This will
  111. unlock the version you are running to the registered version. Until
  112. registered, you are limited to only using 2 subdirectories.
  113.  
  114. FEATURES:
  115. ~~~~~~~~~
  116.            --- Desqview Aware.
  117.            --- COM0-15 support and non-standard IRQ's.
  118.            --- Chat function with automatic screen redraw.
  119.            --- Drop to DOS with automatic screen redraw.
  120.            --- NO BRUN module needed for play.
  121.            --- BETA tested on many different boards.
  122.            --- Will return to BBS on dropped carrier.
  123.            --- Will TIMEOUT a user for no activity.
  124.            --- Support BBS available.
  125.            --- SysOp configurable.
  126.  
  127. INSTALLATION:
  128. ~~~~~~~~~~~~~
  129. CONFIGURATION: (Your FINDER.CFG file)
  130. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  131. ** PLEASE CONSULT YOUR OWN BBS DOCUMENTATION FOR SPECIFICS!!!! **
  132.  
  133. Example configuration file for PCBOARD.SYS
  134. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  135. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  136. T&J Software        <=-  (Change this to your BBS name)
  137. Tom                 <=-  (The Sysop's first name)
  138. Wildoner            <=-  (The Sysop's last name)
  139.  
  140. Example configuration file for USERS.SYS
  141. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  142. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  143. T&J Software        <=-  (Change this to your BBS name)
  144. Tom                 <=-  (The Sysop's first name)
  145. Wildoner            <=-  (The Sysop's last name)
  146.  
  147. Example configuration file for DOOR.SYS
  148. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  149. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  150. T&J Software        <=-  (Change this to your BBS name)
  151. Tom                 <=-  (The Sysop's first name)
  152. Wildoner            <=-  (The Sysop's last name)
  153.  
  154. Example configuration file for USERINFO.DAT
  155. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  156. ** If you are running Wildcat! 3.xx use DOOR.SYS!!!
  157.  
  158. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  159. T&J Software        <=-  (Change this to your BBS name)
  160. Tom                 <=-  (The Sysop's first name)
  161. Wildoner            <=-  (The Sysop's last name)
  162. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  163.  
  164. Example configuration file for CALLINFO.BBS
  165. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  166. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  167. T&J Software        <=-  (Change this to your BBS name)
  168. Tom                 <=-  (The Sysop's first name)
  169. Wildoner            <=-  (The Sysop's last name)
  170.  
  171. Example configuration file for DORINFOx.DEF
  172. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  173. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  174.                           where 'x' is the BBS Node number.
  175. T&J Software        <=-  (Change this to your BBS name)
  176. Tom                 <=-  (The Sysop's first name)
  177. Wildoner            <=-  (The Sysop's last name)
  178.  
  179. Example configuration file for SFDOORS.DAT
  180. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  181. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  182. T&J Software        <=-  (Change this to your BBS name)
  183. Tom                 <=-  (The Sysop's first name)
  184. Wildoner            <=-  (The Sysop's last name)
  185.  
  186. Example Batch File
  187. ~~~~~~~~~~~~~~~~~~
  188. A sample batch file similar to the following:
  189.    ECHO OFF
  190.    CD\DOORS\FINDER          <=- Switch to the door's Directory.
  191.    FINDER FINDER.CFG        <=- Execute the door program and pass the
  192.                                 configuration filename to the program.
  193.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  194.    BOARD                    <=- Restart BBS.
  195.  
  196. This Door is multi-node  compatible so you may run more than 1 node from
  197. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  198. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  199. variables, (q.v.)
  200.  
  201. Environment Variables
  202. ~~~~~~~~~~~~~~~~~~~~~
  203. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  204. variables. Non-PCBoard systems may also use these variables by including
  205. the following in either your BBS batch or AUTOEXEC.BAT
  206.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  207.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  208. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  209. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  210. .CFG file for multi-node operation!
  211.  
  212. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  213. command line.  For example:
  214.  
  215.      FINDER FINDER.CFG /5
  216. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  217.      FINDER FINDER.CFG /%IRQ%
  218.  
  219. This tells the program to use IRQ 5 instead of the standard IRQ.
  220.  
  221.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  222.  systems. Seems Novell also uses the / character so something went screwy
  223.  somewhere. So I added the * (asterisk) which may be used instead of the /
  224.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  225.  and are interchangeable.
  226.  
  227. When specifying the location of the system file on line 1 of the doors .CFG
  228. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  229. and %wcnodeid%. Some examples:
  230.  PCBoard: 
  231.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  232.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  233.  
  234.  Wildcat!:
  235.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  236.  
  237. Non-PCBoard systems may use the PCB environment variables by setting them
  238. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  239.  SET PCBDRIVE=C:
  240.  SET PCBDIR=\BBSDIR
  241.  SET PCBNODE=1
  242.  
  243. Fossil Driver Support
  244. ~~~~~~~~~~~~~~~~~~~~~
  245. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  246. Fossil driver instead of the standard COM ports, just put /FD on the command
  247. line when running the door. For example:
  248.      MYDOOR MYDOOR.CFG /FD
  249. indicates that a Fossil driver is present and should be used. If no Fossil
  250. driver is detected, DoorFrame will print a message to that effect and exit
  251. the door gracefully.
  252.  
  253. Sysop Keys
  254. ~~~~~~~~~~
  255. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  256.          written to DOOR.SYS and USERS.SYS
  257. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  258.          and/or written to DOOR.SYS and USERS.SYS
  259. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  260. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  261.          and/or written to DOOR.SYS and USERS.SYS
  262. F8    -  Returns the caller involuntarily to the BBS.
  263. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  264.          and/or written to DOOR.SYS and USERS.SYS
  265. F10   -  Activates SysOp CHAT mode within the DOOR.
  266. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  267. UP    -  Give the caller extra time while in the DOOR.  
  268. DN    -  Subtract time from the caller while in the DOOR. 
  269. HOME  -  HELP key for Status Line options.
  270. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  271. ALT-X -  PCBoard will exit after current caller logs off. Value is
  272.          passed to PCBoard. Not available on non-PCBoard systems.
  273.  
  274. NOSTAT.DAT FILE:
  275. ~~~~~~~~~~~~~~~~
  276. If you don't want the door statistics shown, create this file in the
  277. FINDER directory.
  278.  
  279. NOARC.DAT FILE:
  280. ~~~~~~~~~~~~~~~
  281. Create a file called NOARC.DAT in the FINDER directory if you want to
  282. bypass the archiving feature.  This may be needed on some systems due
  283. to hardware/software conflicts dealing with shelling from a door and
  284. running PKZIP.EXE.  It doesn't matter what this file contains, only
  285. that it exists in the working directory.
  286.  
  287. MAINTENANCE:
  288. ~~~~~~~~~~~~
  289. After the initial setup, no daily maintenance is required unless you
  290. want to add new subdirectories to the door.
  291.  
  292. PLAYING LOCALLY:
  293. ~~~~~~~~~~~~~~~~
  294. Just type FINDER LOCAL
  295.  
  296. FUTURE VERSIONS:
  297. ~~~~~~~~~~~~~~~~
  298. Let us know what you would like to see added.
  299.  
  300. COMMENTS & QUESTIONS:
  301. ~~~~~~~~~~~~~~~~~~~~~
  302. See the file TJHELP.TXT
  303.  
  304. VERSION HISTORY:
  305. ~~~~~~~~~~~~~~~~
  306. See the HISTORY.TXT file for information on the history of the game
  307. and the new options in the new versions!
  308.  
  309. REGISTERING:
  310. ~~~~~~~~~~~~
  311. That's all there is to it! If you have any problems or questions
  312. please feel free to call the T&J Software BBS at (717)325-9481.
  313.  
  314. See the enclosed registration form for ordering!
  315.  
  316. REGISTER.TXT details on registering Finder!
  317. TJREG.TXT complete details on registering a T&J Software Product
  318. PSREG.TXT complete details on registering a Parole Software Product
  319.