home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BWLSOL13.ZIP / BOWLSOL.DOC < prev    next >
Text File  |  1994-08-14  |  14KB  |  337 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                             BBS BOWLING SOLITAIRE                           ║
  4. ║                                    v1.3                                     ║
  5. ║                                                                             ║
  6. ║                              MULTI-BBS Support                              ║
  7. ║           Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,          ║
  8. ║                UltraBBS, Telegard, TriTel, and Remote Access                ║
  9. ║                                                                             ║
  10. ║                            Copyright 1993, 1994                             ║
  11. ║                               by Robert Neal                                ║
  12. ║                             317 Hickory Avenue                              ║
  13. ║                            Romeoville, IL  60441                            ║
  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 $14.95 along with your name and BBS phone #
  26. to: Robert Neal, 317 Hickory Avenue, Romeoville, IL 60441. 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.  
  203. FOSSIL DRIVER
  204.  
  205. BBS Bowling Solitaire includes support for FOSSIL drivers. This means
  206. that the program will now work with Digiboard (for Wildcat M and
  207. PCBoard/M versions) and other multi-port boards. To activate the Fossil
  208. driver support just include /FD on the command line in your door batch
  209. file.
  210.  
  211.     For example: BOWLSOL BOWLSOL.CFG /FD
  212.  
  213. If no Fossil driver is available, BBS Bowling Solitaire  will display a 
  214. message indicating such and exit cleanly.
  215.  
  216.  
  217. This documentation will not go into the mechanics of how you set-up a
  218. door program on your BBS. It is assumed that you have a working
  219. knowledge of how to complete this task. It would be impossible for me to
  220. explain how to install a door for all BBS programs supported by BBS
  221. Bowling Solitaire.
  222.  
  223.  
  224. SYSOP KEYS ACTIVE
  225.  
  226. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  227.      written to DOOR.SYS and USERS.SYS
  228. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  229.      and/or written to DOOR.SYS and USERS.SYS
  230. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  231. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  232.      and/or written to DOOR.SYS and USERS.SYS
  233. F8    -  Returns the caller involuntarily to the BBS.
  234. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  235.      and/or written to DOOR.SYS and USERS.SYS
  236. F10   -  Activates SysOp CHAT mode within the DOOR.
  237. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  238. UP    -  Give the caller extra time while in the DOOR.  
  239. DN    -  Subtract time from the caller while in the DOOR. 
  240. HOME  -  HELP key for Status Line options.
  241. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  242. ALT-X -  PCBoard will exit after current caller logs off. Value is
  243.      passed to PCBoard. Not available on non-PCBoard systems.
  244.  
  245.  
  246.  
  247.  
  248. FILES USED AND CREATED
  249.  
  250. BOWLSOL.EXE - The program itself
  251. BOWLSOL.DOC - Documentation for the sysop to run BBS Bowling Solitaire
  252. BOWLSOL.CFG - Configuration file
  253. BOWLSOL.HLP - Helpfile displayed to user during program use
  254. OPEN.ANS    - ANSI graphic screen displayed at program start-up
  255.  
  256.  
  257.  
  258. The following scoreboard files will be created by BBS Bowling Solitaire:
  259.  
  260. BOWL        - Non-ansi version
  261. BOWLG       - Ansi version
  262.  
  263.  
  264. CONTACT ME FOR SUPPORT
  265.  
  266. If you encounter any problems you may contact me at CorpSoft BBS
  267. (815) 886-9381.
  268.  
  269. I may be contacted via Internet e-mail at bob.neal@corpsoft.com.
  270.  
  271. I can also be reached via the RIME network in the SYSOP, DOORS, COMMON,
  272. SHAREWARE and BBS SOFTWARE conferences as well as the COMMON conference.
  273. I can also be contacted via the Intelex network in the SYSOP and DOORS
  274. conferences.
  275.  
  276. If you have any suggestions for improvements for this program, please
  277. feel free to let me know.
  278.  
  279.  
  280.                   TROUBLESHOOTING
  281.                =====================
  282.  
  283. If you are running this on a 486 system with co-processor and experience
  284. problems running BBS Bowling Solitaire, you may need to put 'SET NO87=ON' 
  285. in your AUTOEXEC.BAT file or you may place this in the BOWLSOL batch file 
  286. just before the line BOWLSOL BOWLSOL.CFG, for example:
  287.  
  288.      @ECHO OFF
  289.      C:
  290.      CD \BOWLSOL
  291.      SET NO87=ON
  292.      BOWLSOL BOWLSOL.CFG
  293.      %PCBDRIVE%
  294.      CD %PCBDIR%
  295.      IF (%INPCB%)==(Y) EXIT
  296.      BOARD
  297.  
  298.  
  299. If you are running on a 486 system with co-processor under DesqView, you
  300. may alternately set Math Coprocessor in each window to YES.
  301.  
  302.  
  303.  
  304.  
  305. VERSION HISTORY
  306.  
  307.  
  308. v1.0  - Initial release
  309.  
  310. v1.1  - Minor revision to code for improved file sharing capabilities.
  311.         Change for registration key data. Registration ID's for v1.0
  312.         will not work with v1.1, revised registration codes have been
  313.         distributed to all registered users. Simply copy over new
  314.         BOWLSOL.EXE to upgrade.
  315.  
  316. v1.2  - Found problem with handling of monthly scoreboard rollover,
  317.         fixed.
  318.  
  319. v1.3  - Fixed a problem with the scorekeeping.
  320.         Minor internal revisions.
  321.  
  322.  
  323.  
  324. DISTRIBUTION SITES:
  325.  
  326.    As always you can find the latest version of BBS Bowling Solitaire available for
  327.    downloading from CorpSoft BBS.
  328.  
  329.    Calls for support for BBS Bowling Solitaire should be directed only to
  330.    CorpSoft BBS.
  331.  
  332.    CorpSoft BBS   (815) 886-9381  (28800 v.fc)
  333.  
  334. We now can accept Visa and Mastercard. Register online with your Visa or
  335. Mastercard by calling CorpSoft BBS, simply type CHARGE at the main menu
  336. prompt. Or fax your order to us at (815) 886-9388.
  337.