home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / TPSOL100.ZIP / PSOL.DOC < prev    next >
Encoding:
Text File  |  1996-11-09  |  12.5 KB  |  272 lines
  1.                    T&T Software
  2.                 PSOL V1.00
  3.                 (c) Copyright 1996
  4.  
  5. ╔════════════════════════════════════════════════════════════════════════╗
  6. ║  ■ PSOL V1.00 Overview & Instructions ■                                ║
  7. ╚════════════════════════════════════════════════════════════════════════╝
  8. ═ Overview ═
  9. PSOL will ONLY support ANSI mode, this will be checked upon program start up
  10. and if ANSI is NOT on the user will be asked if they can support ANSI.  If the
  11. user responds "Y" then ANSI is turned on for the duration of the door but is
  12. turned off when the door exits!  If the user responds "N" then they are
  13. returned to the BBS.
  14.  
  15. The users will be allowed to play upto the maximum amount of games allowed
  16. per day (set by the SysOp in Registered Versions ONLY, default: 10).
  17.  
  18. Free games are awarded when the user reaches 150 points.  They can win upto
  19. the Free Game Limit. 
  20. (set by the SysOp in Registered Version ONLY, default: 9999).
  21.  
  22. The SysOp may also set the amount of make up/play ahead days that may be
  23. played per day. (set by the SysOp in Registered Versions ONLY, default: 1).
  24. When a user chooses to make up a day a calendar is displayed (CALENDAR.ANS),
  25. if you do not want this calendar to be displayed simply delete it.  
  26.  
  27. The Sysop has the option to change the playing screen background and the
  28. playing card colors via the key file (REGISTERED VERSIONS ONLY, default:
  29. white on white).
  30.  
  31. Users may quit out of the door and their information will be saved in
  32. PSOL.DAT so they can come back in and finish their games anytime. 
  33.  
  34. ═ Instructions ═
  35. Create a directory for PSOL and unarchive or copy all the files into that
  36. directory.
  37.  
  38. Create configuration files for each node that you wish to run PSOL on. 
  39. (See the example configuration files for details).
  40.  
  41. The door can be run with one command line parameter:
  42.  
  43. PSOL NODE1.CFG <-- Configuration filename
  44.  
  45. if this parameter is left off PSOL looks for PSOL.CFG and uses it if
  46. found, if it is not found then the program will abort.
  47.  
  48. To run in the local mode, simply log onto the BBS and run the door or you can
  49. play it without the BBS by setting the LocalMode in the configuration file and
  50. then running PSOL <config.file>.
  51.  
  52. ****Special Configuration File Note****
  53. The configuration file looks really overpowering, but don't shy away from it!
  54. Everything you need to know about the configuration file is within the
  55. configuration file!
  56.  
  57. ╔════════════════════════════════════════════════════════════════════════╗
  58. ║  ■ PSOL Drop File Support ■                                            ║
  59. ╚════════════════════════════════════════════════════════════════════════╝
  60. PSOL will support the following drop files:
  61.  
  62.   1.  DORINFO?.DEF       6.  SFDOORS.DAT
  63.   2.  EXITINFO.BBS       7.  SFMAIN.DAT
  64.   3.  CHAIN.TXT          8.  SFMESS.DAT
  65.   4.  CALLINFO.BBS       9.  SFFILE.DAT
  66.   5.  DOOR.SYS          10.  SFSYSOP.DAT
  67.   
  68. and any other with the use of the CustomFile in the configuration file.
  69.  
  70. ╔════════════════════════════════════════════════════════════════════════╗
  71. ║  ■ PSOL Multi-Node Support ■                                           ║
  72. ╚════════════════════════════════════════════════════════════════════════╝
  73. PSOL is completely Multi-Node aware.  If you are running more than one
  74. node, simply create different configuration files for each node and include
  75. that configuration filename on the command line!
  76.  
  77.  
  78. ╔════════════════════════════════════════════════════════════════════════╗
  79. ║  ■ PSOL Adopted Screen ■                                               ║
  80. ╚════════════════════════════════════════════════════════════════════════╝
  81. After the OPENING.ANS is displayed there is an optional screen called 
  82. ADOPTED.ANS that will be displayed.  This screen is completely user
  83. configurable.  You can thank someone for registering the door for you or
  84. try to encourage someone to do it for you or give them instructions for
  85. the door, whatever you like!
  86.  
  87. If you do not want this screen displayed simply delete it!
  88.  
  89. ╔════════════════════════════════════════════════════════════════════════╗
  90. ║  ■ PSOL How to Play ■                                                  ║
  91. ╚════════════════════════════════════════════════════════════════════════╝
  92. PSOL Cards is a very easy but challenging card game.  Below is a copy of
  93. the HELP.ANS (in ASCII format):
  94.  
  95. ┌────────────────────────────────────────────────────────────────────────────┐
  96. │                        The Rules of Poker Solitaire.                       │
  97. │                                                                            │
  98. │  Layout:  The cards are dealt with all 52 cards in the stock pile.         │
  99. │                                                                            │
  100. │    Play:  You must play the cards one at a time into a 5 by 5 square.      │
  101. │           You have 10 poker hands available.  You can play each card       │
  102. │           anywhere in the square to try and get the highest score.         │
  103. │                                                                            │
  104. │ Scoring:                           Hand              Points                │
  105. │                                                                            │
  106. │                        Royal Flush....................100                  │
  107. │                        Straight Flush..................75                  │
  108. │                        Four of a Kind..................50                  │
  109. │                        Full House......................25                  │
  110. │                        Flush...........................20                  │
  111. │                        Straight........................15                  │
  112. │                        Three of a Kind.................10                  │
  113. │                        Two Pairs........................5                  │
  114. │                        One Pair.........................2                  │
  115. │                                                                            │
  116. │ Winning:  The game is considered won if you score 150 points!              │
  117. └────────────────────────────────────────────────────────────────────────────┘
  118.  
  119.  
  120. ╔════════════════════════════════════════════════════════════════════════╗
  121. ║  ■ PSOL Scoring ■                                                      ║
  122. ╚════════════════════════════════════════════════════════════════════════╝
  123. Scoring is based on the following table:
  124.  
  125.             Royal Flush..............100
  126.             Straight Flush............75
  127.             Four of a Kind............50
  128.             Full House................25
  129.             Flush.....................20
  130.             Straight..................15
  131.             Three of a Kind...........10
  132.             Two Pairs..................5
  133.             One Pair...................2
  134.  
  135. Scores are kept for one month in the PSOL.DAT file and the Top Ten
  136. is kept in PSOL.SCR.  An alltime high is kept in PALLTIME.DAT.
  137. PSOL.MB4 will contain the previous months scores!
  138.  
  139. GAMEHIGH.DAT contains highest scores for a single game.  This is a Top Ten
  140. score file and may be reset by simply deleting it.
  141.  
  142. On the first of the month PSOL.DAT will be removed and PSOL.SCR
  143. will be renamed to PSOL.MB4 when the first player enters the door!
  144.  
  145. When in the game 'V' will display the scores, with the Alltime high and
  146. last months highest score first, with this months top ten following in 
  147. the next screen.
  148.  
  149. ╔════════════════════════════════════════════════════════════════════════╗
  150. ║  ■ PSOL Files in Archive ■                                             ║
  151. ╚════════════════════════════════════════════════════════════════════════╝
  152.  
  153. Your TPSOL100.ARJ file should contain the following files:
  154.  
  155.           Psol.exe -> The Executable File.
  156.           Psol.doc -> This Document File.
  157.           Psol.reg -> Registration Form.
  158.           Psol.his -> History of Releases.
  159.           Psol.upg -> Upgrade information.
  160.  
  161.       Plbullet.exe -> Creates External Bulletins
  162.       Plbullet.cfg -> Configuration File for Pbullet.exe.
  163.      
  164.        File_id.diz -> Short Program Description.
  165.  
  166.           Psol.key -> Registration Key File.
  167.  
  168.           Psol.cfg -> Example Configuration File. 
  169.          Local.cfg -> Example Local Configuration File.
  170.  
  171.           Main.ans -> Ansi Main Menu.
  172.           Help.ans -> Ansi Help Screen.
  173.        Adopted.ans -> Ansi Adopted Screen.
  174.        Opening.ans -> Ansi Opening Screen.
  175.       Calendar.ans -> Ansi Calendar Screen (for Make up Days).
  176.  
  177.       Edituser.exe -> Data File Editor.
  178.       Edituser.doc -> Document File for Edituser.
  179.  
  180.       Psoreset.bat -> Deletes all Data Files that Psol Creates.
  181.       
  182.       Support.doc -> Support Information.
  183.        Others.doc -> Other Doors by T&T Software.
  184.  
  185.        ═════ Files Created at Run-Time ═════
  186.           Psol.dat -> User Data, contains the Username,
  187.               Last date played, games won, total points,
  188.               and games played.
  189.           Psol.scr -> Top Ten Scores Data File.
  190.       Palltime.dat -> Alltime high Data File.
  191.           Psol.mb4 -> Scores From the Month Before.
  192.       Gamehigh.dat -> Top Ten High Games Data File.
  193.  
  194. ╔════════════════════════════════════════════════════════════════════════╗
  195. ║  ■ PSOL Configuration File ■                                           ║
  196. ╚════════════════════════════════════════════════════════════════════════╝
  197. The Configuration file may be named anything you wish to name it, but it must
  198. be included on the command line for PSOL to use it.  If you do not specify
  199. a configuration file on the command line then PSOL will try to use 
  200. PSOL.CFG, if that is not found the program will abort.
  201.  
  202. Everything that you need to know about the Configuration file is within the
  203. configuration file.....
  204.  
  205. ╔════════════════════════════════════════════════════════════════════════╗
  206. ║  ■ PSOL Registration Information ■                                     ║
  207. ╚════════════════════════════════════════════════════════════════════════╝
  208. Registration of PSOL reflects the concept of Shareware.
  209.  
  210. Please see PSOL.REG for details on registering.
  211.  
  212.  
  213. ╔════════════════════════════════════════════════════════════════════════╗
  214. ║  ■ PSOL External Bulletins ■                                           ║
  215. ╚════════════════════════════════════════════════════════════════════════╝
  216. PSOL can create external bulletins via PBULLET.EXE.  PBULLET will read
  217. the PBULLET.CFG and will create any or all of the Ansi, Ascii, or Rip
  218. bulletins.  Simply run PBULLET and it will pick up the default PBULLET.CFG
  219. configuration file, or specify which configuration file you would like to
  220. use on the command line:
  221.  
  222. PBULLET <configfilename>
  223.  
  224. PBULLET must reside in the same directory as PSOL and PSOL NEEDS to
  225. BE REGISTERED.  If PSOL is NOT registered, a message will be displayed
  226. and the program will exit!
  227.  
  228. Please see the enclosed PBULLET.CFG for details on how to configure PBULLET.
  229.  
  230. ╔════════════════════════════════════════════════════════════════════════╗
  231. ║  ■ PSOL V1.00 Credits and Many Thanks ■                                ║
  232. ╚════════════════════════════════════════════════════════════════════════╝
  233. Special thanks go to Brian Pirie who wrote "OpenDoors, Door Programming
  234. Toolkit Version 6.00" with which PSOL was created!
  235.  
  236. A very special thanks go to the following for spending the time to BETA
  237. test the earliest versions of the door:
  238.  
  239. Chris Cook
  240. Della Moore
  241. Steve Newman
  242.  
  243. Thanks to Susana Emberg for the external screens!
  244.  
  245. Full support will be given on The Ultimate House Of Fun BBS, please call we
  246. would like to hear any concerns or comments!
  247.  
  248. ╔════════════════════════════════════════════════════════════════════════╗
  249. ║  ■ PSOL Warranty and Disclaimer ■                                      ║
  250. ╚════════════════════════════════════════════════════════════════════════╝
  251.  = Warranty =
  252. This product is provided "as is" without warranty of any kind.  The entire
  253. risk as to the results and performance of the program is assumed by you.
  254. Futhermore, we the authors do not warrant, guarantee, or make any represent-
  255. tions regarding the use of, or the results of the use of the program, and you
  256. rely on the program and results solely at your own risk. We the authors cannot
  257. accept responsibility for system damage, either directly or indirectly from
  258. the use of this product.
  259.  
  260.  = Disclaimer =
  261. The Authors of this program, The Ultimate House Of Fun BBS and its Co-sysops
  262. are in no way responsible for any damages sustained either directly
  263. or indirectly from the use of PSOL.  Also if the file has been
  264. modified in any way we will take no responsibility for it's use Whatsoever!
  265. The .EXE file has been tested on several machines, from 286's to 486's and
  266. worked perfectly on all. If you should have any problems with this file
  267. please call The Ultimate House Of Fun BBS to obtain a good copy.
  268.  
  269. The latest version of this program may be FREQ'd by using:
  270.  
  271.   PSOL
  272.