home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / WFB!20.ZIP / WFB.DOC < prev    next >
Encoding:
Text File  |  1994-11-22  |  9.9 KB  |  248 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │============================│
  4.                       │    World Factbook Door     │
  5.                       │============================│
  6.                       │COPYRIGHT 1994 T&J Software │
  7.                       └────────────────────────────┘
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.                UltraBBS, Telegard, TriBBS, and Remote Access.
  11.  
  12.  
  13.                        VERSION 2.00     11/05/94
  14.  
  15.                                    By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.  
  22.                                   From
  23.  
  24.                            The T&J Software BBS
  25.                            (717)325-9481 14.4k
  26.                            (717)325-4369 28.8k
  27.                     Internet: tom.wildoner@channel1.com
  28.  
  29.  
  30. LATEST VERSION:
  31. ^^^^^^^^^^^^^^^
  32. Please call the T&J BBS for the latest version of this program.
  33.  
  34. LEGALITIES:
  35. ^^^^^^^^^^^
  36. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  37. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  38. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  39. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  40. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  41. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  42.  
  43. DISTRIBUTION:
  44. ^^^^^^^^^^^^^
  45. You may make this file available for downloading from your BBS or you may
  46. upload it to any BBS of your choice, provided that you do not make any
  47. changes to the contents of the archive (ZIP file). The archive and its
  48. individual contents may not be used by any service that charges any money
  49. whatsoever, without the written permission of the author.
  50.  
  51. PROGRAM DESCRIPTION:
  52. ^^^^^^^^^^^^^^^^^^^^
  53. The World Factbook Door is an online reference library which utilizes
  54. the World Factbook Data for 1994. Information is provided on every
  55. country in the world.
  56.  
  57. CONFIGURATION: (The WFB.CFG file)
  58. ^^^^^^^^^^^^^^
  59. Run --->  WFB UTILITY   to easily setup your WFB.CFG file!
  60.  
  61.  
  62. Example configuration file for PCBOARD.SYS
  63. ------------------------------------------
  64. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  65. T&J Software        <=-  (Change this to your BBS name)
  66. Tom                 <=-  (The Sysop's first name)
  67. Wildoner            <=-  (The Sysop's last name)
  68.  
  69. Example configuration file for USERS.SYS
  70. ----------------------------------------
  71. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  72. T&J Software        <=-  (Change this to your BBS name)
  73. Tom                 <=-  (The Sysop's first name)
  74. Wildoner            <=-  (The Sysop's last name)
  75.  
  76. Example configuration file for DOOR.SYS
  77. ---------------------------------------
  78. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  79. T&J Software        <=-  (Change this to your BBS name)
  80. Tom                 <=-  (The Sysop's first name)
  81. Wildoner            <=-  (The Sysop's last name)
  82.  
  83. Example configuration file for USERINFO.DAT
  84. -------------------------------------------
  85. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  86. T&J Software        <=-  (Change this to your BBS name)
  87. Tom                 <=-  (The Sysop's first name)
  88. Wildoner            <=-  (The Sysop's last name)
  89. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  90.  
  91. Example configuration file for CALLINFO.BBS
  92. -------------------------------------------
  93. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  94. T&J Software        <=-  (Change this to your BBS name)
  95. Tom                 <=-  (The Sysop's first name)
  96. Wildoner            <=-  (The Sysop's last name)
  97.  
  98. Example configuration file for DORINFOx.DEF
  99. -------------------------------------------
  100. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  101.                           where 'x' is the BBS Node number.
  102. T&J Software        <=-  (Change this to your BBS name)
  103. Tom                 <=-  (The Sysop's first name)
  104. Wildoner            <=-  (The Sysop's last name)
  105.  
  106. Example configuration file for SFDOORS.DAT
  107. ------------------------------------------
  108. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  109. T&J Software        <=-  (Change this to your BBS name)
  110. Tom                 <=-  (The Sysop's first name)
  111. Wildoner            <=-  (The Sysop's last name)
  112.  
  113. Example configuration file for GTUSER.BBS
  114. -----------------------------------------
  115. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  116. T&J Software        <=-  (Change this to your BBS name)
  117. Tom                 <=-  (The Sysop's first name)
  118. Wildoner            <=-  (The Sysop's last name)
  119. 1                   <=-  (COM port number - defaults to 1)
  120. 1                   <=-  (Node number - defaults to 1)
  121.  
  122. Example Batch File
  123. ^^^^^^^^^^^^^^^^^^
  124. A sample batch file is included and is similer to the following:
  125.    ECHO OFF
  126.    CD\DOORS\ONLINE          <=- Switch to the door's Directory.
  127.    WFB WFB.CFG              <=- Execute the door program and pass the
  128.                                 configuration filename to the program.
  129.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  130.    BOARD                    <=- Restart BBS.
  131.  
  132.  
  133. This Door is multi-node  compatible so you may run more than 1 node from
  134. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  135. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  136. variables, (q.v.)
  137.  
  138. Normally, when running multinode, just setup different BIBLE.CFG files
  139. for each node:   WFB1.CFG   WFB2.CFG  etc....
  140.  
  141.  
  142. Environment Variables
  143. ^^^^^^^^^^^^^^^^^^^^^
  144. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  145. variables. Non-PCBoard systems may also use these variables by including
  146. the following in either your BBS batch or AUTOEXEC.BAT
  147.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  148.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  149. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  150. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  151. .CFG file for multi-node operation!
  152.  
  153. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  154. command line.  For example:
  155.  
  156.      WFB WFB.CFG /5
  157. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  158.      WFB WFB.CFG /%IRQ%
  159.  
  160. This tells the program to use IRQ 5 instead of the standard IRQ.
  161.  
  162.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  163.  systems. Seems Novell also uses the / character so something went screwy
  164.  somewhere. So I added the * (asterisk) which may be used instead of the /
  165.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  166.  and are interchangeable.
  167.  
  168. When specifying the location of the system file on line 1 of the doors .CFG
  169. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  170. and %wcnodeid%. Some examples:
  171.  PCBoard: 
  172.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  173.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  174.  
  175.  Wildcat!:
  176.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  177.  
  178. Non-PCBoard systems may use the PCB environment variables by setting them
  179. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  180.  SET PCBDRIVE=C:
  181.  SET PCBDIR=\BBSDIR
  182.  SET PCBNODE=1
  183.  
  184.  
  185. Fossil Driver Support
  186. ^^^^^^^^^^^^^^^^^^^^^
  187. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  188. Fossil driver instead of the standard COM ports, just put /FD on the command
  189. line when running the door. For example:
  190.      MYDOOR MYDOOR.CFG /FD
  191. indicates that a Fossil driver is present and should be used. If no Fossil
  192. driver is detected, DoorFrame will print a message to that effect and exit
  193. the door gracefully.
  194.  
  195.  
  196. Sysop Keys
  197. ^^^^^^^^^^
  198. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  199.          written to DOOR.SYS and USERS.SYS
  200. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  201.          and/or written to DOOR.SYS and USERS.SYS
  202. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  203. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  204.          and/or written to DOOR.SYS and USERS.SYS
  205. F8    -  Returns the caller involuntarily to the BBS.
  206. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  207.          and/or written to DOOR.SYS and USERS.SYS
  208. F10   -  Activates SysOp CHAT mode within the DOOR.
  209. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  210. UP    -  Give the caller extra time while in the DOOR.  
  211. DN    -  Subtract time from the caller while in the DOOR. 
  212. HOME  -  HELP key for Status Line options.
  213. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  214. ALT-X -  PCBoard will exit after current caller logs off. Value is
  215.          passed to PCBoard. Not available on non-PCBoard systems.
  216.  
  217. PROBLEMS:
  218. ^^^^^^^^^
  219. See the TJHELP.TXT file!
  220. Please feel free to contact me if you have any problems at all.
  221.  
  222. MAINTENANCE:
  223. ^^^^^^^^^^^^
  224. No nightly maintenance required.
  225.  
  226. RUNNING LOCALLY:
  227. ^^^^^^^^^^^^^^^^
  228. To run in LOCAL mode simply type WFB LOCAL
  229.  
  230. FUTURE VERSIONS:
  231. ^^^^^^^^^^^^^^^^
  232. Let me know what you would like to see added!!
  233.  
  234. VERSION HISTORY:
  235. ^^^^^^^^^^^^^^^^
  236. Version 1.00 ......... First release. 03/26/94
  237. Version 2.00 ......... 11/21/94. Updated the database to include all the
  238.                        data from the 1994 CIA World Fact Book. Lowered
  239.                        HD space requirements by about 7 megs.
  240.  
  241. REGISTERING:
  242. ^^^^^^^^^^^^
  243. That's all there is to it! If you have any problems or questions
  244. please feel free to call the T&J BBS at (717)325-9481 and join the
  245. T&J Software Conference.
  246.  
  247. See the enclosed registration form for ordering!  (REGISTER.TXT)
  248.