home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / BWLSOL14.ZIP / BOWLSOL.DOC < prev    next >
Text File  |  1996-09-22  |  17KB  |  414 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                             BBS BOWLING SOLITAIRE                           ║
  4. ║                                    v1.4                                     ║
  5. ║                                                                             ║
  6. ║                              MULTI-BBS Support                              ║
  7. ║           Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,          ║
  8. ║                UltraBBS, Telegard, TriTel, and Remote Access                ║
  9. ║                                                                             ║
  10. ║                           Copyright 1993 - 1996                             ║
  11. ║                               by Robert Neal                                ║
  12. ║                             317 Hickory Avenue                              ║
  13. ║                            Romeoville, IL  60446                            ║
  14. ║                                                                             ║
  15. ║                                CorpSoft BBS                                 ║
  16. ║                        3 Nodes - (815) 886-9381 28.8                        ║
  17. ║                                                                             ║
  18. ╚═════════════════════════════════════════════════════════════════════════════╝
  19.  
  20.  
  21. BBS Bowling Solitaire is released as SHAREWARE. You are granted a limited 
  22. license to evaluate the program. Try it out, if you continue to use it you 
  23. are required to register the program.
  24.  
  25. To register the program send $15.00 along with your name and BBS phone #
  26. to: Robert Neal, 317 Hickory Avenue, Romeoville, IL 60446. See the file
  27. MAILER.TXT for additonal pricing information and special discounts
  28. available. You may also register ONLINE with Visa or MasterCard by
  29. calling the support BBS at (815) 886-9381. Simply type CHARGE at the
  30. main menu.
  31.  
  32. Once you register BBS Bowling Solitaire, you will be given your own
  33. unique registration number that will inform BBS Bowling Solitaire that
  34. the program is registered. The BBS name supplied with payment will be
  35. the name used to create your unique registration number.
  36.  
  37. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  38. CHARGE AND WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING
  39. BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  40. FOR A PARTICULAR PURPOSE.  IN NO EVENT SHALL ANYONE INVOLVED WITH THE
  41. CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL,
  42. OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF
  43. ANY WARRANTY.
  44.  
  45.  
  46. BBS Bowling Solitaire is a online game, and as the name suggests, is a
  47. solitaire card game. The player tries to score as many pins as possible
  48. by playing from a standard 52 card deck. Each card drawn is placed in
  49. the "rack" in increasing card rank. As there are 10 pins and 13 card
  50. values, the player gets 3 discards for cards not able to be played. Each
  51. time 3 cards are discarded, that counts as a ball thrown and the number
  52. of pins placed are calculated for that half of the frame. The player is
  53. scored by how many pins he was able to place in the "rack". Scoring is
  54. then done based on the regular rules of bowling, with strikes being
  55. scored for being able to place all cards in the rack before using up his
  56. 3 discards for his first ball.
  57.  
  58. BBS Bowling Solitaire requires ANSI graphics, though the user does not  
  59. require the user to be in color mode. 
  60.  
  61. BBS Bowling Solitaire keeps track of dual scoreboards, one ranking each
  62. player on their total pins and a second ranking the top 10 high games
  63. scored for the month. BBS Bowling Solitaire will automatically reset the
  64. scoreboard at the start of each month requiring no sysop maintenance
  65. after initial set-up.
  66.  
  67.  
  68. FEATURES OF BBS Bowling Solitaire:
  69.  
  70.   -  Easy to install and requires no maintenance.
  71.  
  72.   -  Ansi colors and display.
  73.  
  74.   -  Terminates cleanly through exit code even on runtime error.
  75.  
  76.   -  Automatically creates a top score listing suitable for inclusion
  77.      as a text/bulletin file for display within your BBS. Both an
  78.      ANSI and ASCII file is created.
  79.  
  80.   -  Detects loss of carrier.
  81.  
  82.   -  Operates in local mode (either direct from BBS or from command line).
  83.  
  84.   -  Sysop function keys to return to the board, chat mode, user stats,
  85.      increase/decrease time, etc.
  86.  
  87.   -  Direct support for PCBoard, WildCat!, Gap, QBBS, RBBS,
  88.      Ultra BBS, Telegard, TriTel and Remote Access.
  89.  
  90.   -  Support for baud rates up to 115,200
  91.  
  92.   -  Support for COM1-15. Optional command line for non-standard IRQ's.
  93.  
  94.   -  Supports PCBoard environment variables %PCBDRIVE% and %PCBDIR%
  95.  
  96.   -  Support Fossil Drivers. A Fossil driver is not required to use the
  97.      program.
  98.  
  99.   -  Fully Multi-Node compatible.
  100.  
  101.   -  Support for multi-port digiboards, for use with PCBoard /M.
  102.  
  103.  
  104. FIRST TIME OPERATIONS
  105.  
  106. Simply create a directory for BBS Bowling Solitaire and copy all files 
  107. distributed with BBS Bowling Solitaire to this directory. Additional 
  108. data files will automatically be created the first time BBS Bowling 
  109. Solitaire is run.
  110.  
  111.  
  112. CONFIGURING THE PROGRAM
  113. Using the editor included, BSCONFIG.EXE, or your favorite text editor, 
  114. edit the file BOWLSOL.CFG. Below is the layout of this file:
  115.  
  116. C:\PCB\PCBOARD.SYS
  117. CorpSoft BBS
  118. Bob
  119. Neal
  120. 15
  121. 0
  122. NA
  123.  
  124. Line 1 = Full pathname of your door file. Formats supported by this
  125.      program are: PCBOARD.SYS, USERS.SYS, DOOR.SYS, USERINFO.DAT,
  126.               CALLINFO.BBS, DORINFOx.DEF, SFDOORS.DAT and
  127.               GTUSER.BBS, DOOR.SYS, and TRIBBS.SYS. When using
  128.               USERINFO.DAT, DOOR.SYS  must be in the same
  129.               directory as USERINFO.DAT.
  130. Line 2 = BBS name
  131. Line 3 = Sysop First Name
  132. Line 4 = Sysop Last Name
  133. Line 5 = number of games per day that a player may play. I suggest
  134.         a daily limit of 3, but tailor to your own needs.
  135. Line 6 = Registration number. Leave as 0 if unregistered.
  136. Line 7 = You can place the name of the user who helped pay for the
  137.         registration of the door. Several sysops have specified that
  138.         users have paid the reigstration fee for BBS Bowling Solitaire. 
  139.         You can now place their name on this line and their name will be
  140.         proudly displayed at the end of the game so that others may
  141.         recognize their contribtion to the operation of your BBS.
  142.         Leave this blank or NA if you do not wish to use this
  143.         option.
  144.  
  145. Note: This door supports the PCBoard environment variables %PCBDRIVE%
  146. and %PCBDIR%. Non-PCBoard systems may also use these variables by
  147. including the following either in your BBS batch or AUTOEXEC.BAT file:
  148.  
  149.     SET PCBDRIVE=C:            <- Drive letter of your BBS files
  150.     SET PCBDIR=\BBS            <- Path of your BBS files
  151.  
  152. Then, in your BOWLSOL.CFG file, on the first line you may put:
  153.  
  154.    %PCBDRIVE%%PCBDIR%\PCBOARD.SYS, %PCBDRIVE%%PCBDIR%\DOOR.SYS, etc.
  155.  
  156. This allows you to use just one .CFG file for multi-node operation.
  157.  
  158.  
  159.  
  160. EXECUTING PROGRAM
  161.  
  162. To execute the program, enter the filename followed by the config file
  163. name (ie BOWLSOL BOWLSOL.CFG). If you are running the program from the
  164. command line, you may optionally enter BOWLSOL LOCAL. The only problem
  165. with this is the default user name sysop is used instead of the name on
  166. your board. This is good for testing the game before putting it on your
  167. system, but you should once play begins, execute the program locally
  168. from your BBS or consistantly run the game from the command line when
  169. you play.
  170.  
  171. You may also specify a non-standard IRQ. Put the IRQ number after the
  172. .CFG on the command line. For example: BOWLSOL BOWLSOL.CFG /5. This
  173. example tells the program to use IRQ 5 instead of the standard IRQ.
  174.  
  175. You may also use the procedure above and create a variable IRQ so that
  176. you can pass the IRQ setting as: BOWLSOL BOWLSOL.CFG /%IRQ%
  177.  
  178. Some users may have had conflicts when using non-standard IRQ's on
  179. Novell/Netware systems. Novell seems to use the "/" character for
  180. parameter passing. You may not optionally use the "*" character instead
  181. of the "/", for example BOWLSOL BOWLSOL.CFG *%IRQ% is valid. Both "*"
  182. and "/" will work.
  183.  
  184.  
  185. AUTOMATIC MAINTENANCE
  186.  
  187. The program will automatically during the first play of each new month
  188. reset it's user file and top score listing. The previous months
  189. scoreboard will automatically be renamed to BOWLSOL.OLD and BOWLSOL.OLD.
  190. This can then be included as a text file to display the previous months
  191. winners.
  192.  
  193. You should be aware of this so if you are starting a new game for the
  194. first time towards the end of the month, the game will automatically
  195. perform the maintenace come the first of the month.
  196.  
  197. As an option, you may pass the parameter "NEW" on the command line, for 
  198. example BOWLSOL NEW. This will reset _all_ BBS Bowling Solitaire data
  199. files, including the overall high game information.
  200.  
  201.  
  202. ADOPTED BY OPTION (Registered version only)
  203.  
  204. Many sysops are fortunate to have their users offer to register a door
  205. they enjoy playing. You can now give recognition to the user or users
  206. who assist in contributing to the registration of this program. Simply 
  207. enter their name(s) on the appropriate line in the configuration file.
  208.  
  209. When unregistered, the door will inform the user that they can adopt
  210. the door and refers them to ask you for details. You can give the
  211. user the registration form for them to send in if you'd like.
  212.  
  213. After the program is registered, each time a user quits the game a
  214. screen will be displayed informing other users who contributed towards
  215. the registration of the game. 
  216.  
  217. If you wish to disable this option, enter NA on the line in the 
  218. configuration file.
  219.  
  220.  
  221. FOSSIL DRIVER
  222.  
  223. BBS Bowling Solitaire includes support for FOSSIL drivers. This means
  224. that the program will now work with Digiboard (for Wildcat M and
  225. PCBoard/M versions) and other multi-port boards. To activate the Fossil
  226. driver support just include /FD on the command line in your door batch
  227. file.
  228.  
  229.     For example: BOWLSOL BOWLSOL.CFG /FD
  230.  
  231. If no Fossil driver is available, BBS Bowling Solitaire  will display a 
  232. message indicating such and exit cleanly.
  233.  
  234.  
  235. This documentation will not go into the mechanics of how you set-up a
  236. door program on your BBS. It is assumed that you have a working
  237. knowledge of how to complete this task. It would be impossible for me to
  238. explain how to install a door for all BBS programs supported by BBS
  239. Bowling Solitaire.
  240.  
  241.  
  242. MULTI-NODE OPERATION
  243.  
  244. If you are running a multi-node BBS, there are two ways which you      
  245. can set-up War of the Words.
  246.     
  247.     1. Create a seperate configuration file for each node.
  248.        The only difference between the configuration files would
  249.        be the location of your BBS drop file. 
  250.     
  251.     2. You can use one configuration file for all nodes by 
  252.        using an environment variable. Both PCBoard and Wildcat
  253.        provide these automatically when running a door program.
  254.        For PCBoard, the environment variables are PCBDIR and PCBDRIVE.
  255.        You can then place the following on the first line of your
  256.        configuration file:
  257.         %PCBDRIVE%%PCBDIR%\PCBOARD.SYS
  258.        For Wildcat systems, it uses the variable WCNODEID, you can 
  259.        place the following on the first line of your configuration
  260.        file: 
  261.         C:\WC30\WCWORK\NODE%WCNODEID%\DOOR.SYS
  262.  
  263.        If you are running other BBS software, you should be able to
  264.        create these variables so that you can run the program as
  265.        explained above.
  266.  
  267.        Other BBS systems may also use these variables by
  268.        including the following either in your BBS batch or 
  269.        AUTOEXEC.BAT file:
  270.  
  271.         SET PCBDRIVE=C:            <- Drive letter of your BBS files
  272.         SET PCBDIR=\BBS            <- Path of your BBS files
  273.  
  274.  
  275. SYSOP KEYS ACTIVE
  276.  
  277. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  278.      written to DOOR.SYS and USERS.SYS
  279. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  280.      and/or written to DOOR.SYS and USERS.SYS
  281. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  282. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  283.      and/or written to DOOR.SYS and USERS.SYS
  284. F8    -  Returns the caller involuntarily to the BBS.
  285. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  286.      and/or written to DOOR.SYS and USERS.SYS
  287. F10   -  Activates SysOp CHAT mode within the DOOR.
  288. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  289. UP    -  Give the caller extra time while in the DOOR.  
  290. DN    -  Subtract time from the caller while in the DOOR. 
  291. HOME  -  HELP key for Status Line options.
  292. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  293. ALT-X -  PCBoard will exit after current caller logs off. Value is
  294.      passed to PCBoard. Not available on non-PCBoard systems.
  295.  
  296.  
  297.  
  298.  
  299. FILES USED AND CREATED
  300.  
  301. BOWLSOL.EXE - The program itself
  302. BOWLSOL.DOC - Documentation for the sysop to run BBS Bowling Solitaire
  303. BOWLSOL.CFG - Configuration file
  304. BOWLSOL.HLP - Helpfile displayed to user during program use
  305. OPEN.ANS    - ANSI graphic screen displayed at program start-up
  306.  
  307.  
  308.  
  309. The following scoreboard files will be created by BBS Bowling Solitaire:
  310.  
  311. BOWL        - Non-ansi version
  312. BOWLG       - Ansi version
  313.  
  314.  
  315. CONTACT ME FOR SUPPORT
  316.  
  317. If you encounter any problems you may contact me at CorpSoft BBS
  318. (815) 886-9381.
  319.  
  320. I may be contacted via Internet e-mail at bob.neal@corpsoft.com.
  321.  
  322. I can also be reached via the RIME network in the SYSOP, DOORS, COMMON,
  323. SHAREWARE and BBS SOFTWARE conferences as well as the COMMON conference.
  324. I can also be contacted via the Intelex network in the SYSOP and DOORS
  325. conferences.
  326.  
  327. If you have any suggestions for improvements for this program, please
  328. feel free to let me know.
  329.  
  330.  
  331. DISTRIBUTION SITES
  332.  
  333.    As always you can find the latest version of War of the Words available
  334.    for downloading from CorpSoft BBS.
  335.  
  336.    CorpSoft BBS   (815) 886-9388 (3 nodes with automatic ring-down,
  337.                   running USR 28800 v.everything)
  338.  
  339. We also accept Visa and Mastercard. Register online with your Visa or
  340. Mastercard by calling CorpSoft BBS, simply type CHARGE at the main menu
  341. prompt.
  342.  
  343. User's with FIDO capabilities can FREQ the latest version of my software 
  344. from me at 1:2235/886. The magic names for my software are:
  345.     WOTW            War of the Words
  346.     KING            Kings are Wild Solitaire
  347.     CARD            Card Sharks
  348.     BOWL            BBS Bowling Solitaire
  349.     GOLF            Links Golf
  350.     ZWORD           Z-Wordz
  351.     CORPSOFT        All my shareware releases
  352.  
  353. You can also download our files via our web site. Visit us at
  354. http://user.aol.com/corpsoft
  355.  
  356. To further make it convenient for people to download my software, you can
  357. also login to my support BBS by enter CORPSOFT GUEST when prompted for 
  358. your name. You will not need to go through the new user information
  359. questionaire and will immediately be able to download my shareware. 
  360. Please note that if you wish to register online, you will need to
  361. set-up a user account so that your registration keys can be made available
  362. to you.
  363.  
  364.  
  365. TROUBLESHOOTING
  366.  
  367. -  If you are running this Door on a 486 system and encounter an error
  368.    message "ERROR 6 - OVERFLOW ERROR" or you experience irratic Keyboard
  369.    Timeout messages, you may have to put the following in either your
  370.    AUTOEXEC.BAT file or in the batch file you use to call this program.
  371.  
  372.      SET NO87=ON
  373.  
  374.    If you are running on a 486 system with co-processor under DesqView, you
  375.    may alternately set Math Coprocessor in each window to YES.
  376.  
  377. -  If you encounter an ERROR 62 when the program first is loaded, this
  378.    will usually indicate that there is an error in your .CFG file. 
  379.    Recheck your .CFG file to verify the proper format (if you use the
  380.    BSCONFIG program you should never encounter this error).
  381.  
  382. -  An ERROR 70 message means you more than likely do not have SHARE
  383.    loaded. This is typically only required for multi-node systems.
  384.  
  385.  
  386.  
  387. VERSION HISTORY
  388.  
  389.  
  390. v1.0  - Initial release
  391.  
  392. v1.1  - Minor revision to code for improved file sharing capabilities.
  393.     Change for registration key data. Registration ID's for v1.0
  394.     will not work with v1.1, revised registration codes have been
  395.     distributed to all registered users. Simply copy over new
  396.     BOWLSOL.EXE to upgrade.
  397.  
  398. v1.2  - Found problem with handling of monthly scoreboard rollover,
  399.     fixed.
  400.  
  401. v1.3  - Fixed a problem with the scorekeeping.
  402.     Minor internal revisions.
  403.  
  404. v1.4  - Revised display for 10th frame, if spare is scored, only 1 ball
  405.     is left to roll. Display now shows that player only has one
  406.     throw and not two as previous version indicated.
  407.  
  408.     Modified the game graphics for a hopefully more eye pleasing
  409.     display.
  410.  
  411.     Modified help system.
  412.  
  413.  
  414.