home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 398 / DBLSOL11.ZIP / DBLSOL.DOC < prev    next >
Encoding:
Text File  |  1993-09-24  |  14.5 KB  |  325 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                         Double Solitaire                       /
  4.     /                           Version 1.1                          /
  5.     /                                                                /
  6.     /                        (c) Copyright 1993                      /
  7.     /                        All Rights Reserved                     /
  8.     /                          J & W Software                        /
  9.     /                                                                /
  10.     /                                                                /
  11.     /       DOOR game  for  Wildcat!,  PCBoard,  RA/QBBS,  GAP,      /
  12.     /       SPITFIRE  and  other BBS  software which  uses door      /
  13.     /       information files compatible with the above.             /
  14.     /                                                                /
  15.     /                                                                /
  16.     /                           Support BBS:                         /
  17.     /                          Gulf Coast BBS                        /
  18.     /                          (904) 563-2547                        /
  19.     /                     1200 - 14400 HST/v.32bis                   /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     Double Solitaire is a  DOOR  implementation  of a double solitaire
  27.     card game.  The object of the game is to play all of your cards to
  28.     the layout before your opponent, in this case the Computer,  while
  29.     scoring as many  points as you can.  Players compete for weekly as
  30.     well as all time high scores.
  31.  
  32.  
  33.     FEATURES
  34.     --------
  35.  
  36.     - ANSI Color and Mono screens
  37.     - RIPscrip mode graphics
  38.     - Full multi-node support
  39.     - Support for locked DTE up to 115K bps
  40.     - Support for COM1 through COM8 and IRQs 1 through 15
  41.     - FOSSIL support
  42.     - DESQview aware
  43.     - Easy installation and no maintenance
  44.  
  45.  
  46.     SETUP
  47.     -----
  48.  
  49.     Setup  is  very simple.  Create a directory and  place  the  files 
  50.     DBLSOL.EXE,  DBLSETUP.EXE,   JWCARDS.ZIP  and   SEND.BAT  in  this
  51.     directory.
  52.  
  53.     Change to  this directory and run DBLSETUP.  A screen with several
  54.     fields  will be displayed.  There will be a box at the  bottom  of 
  55.     the  screen that will  display  help  information for each  field.
  56.     The  following  edit keys  are allowed: HOME, END, BACKSPACE, LEFT
  57.     and RIGHT ARROW. Use the ENTER,  UP  and  DOWN  ARROW keys to move
  58.     between the different fields.
  59.  
  60.     Each field is described below:
  61.  
  62.     Name: The name of the person registering the program as it will be
  63.     displayed on  the opening screen (when registered).  This does not
  64.     necessarily have  to  be the SysOp, it could be the name of a user
  65.     who donated the registration fee.
  66.  
  67.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  68.     opening screen (when registered).
  69.  
  70.     Key Number:  If registered, enter your Key Number here.  Until the
  71.     program  is registered leave this field  as  all zeroes.   See the
  72.     registration section below for more information about registering.
  73.  
  74.     Allowable games per day:  The  number of games  per day  that each
  75.     player will be allowed to play. Players will be allowed to call in
  76.     any  number of  times during the  day to  complete  this number of
  77.     games.  Entering zero will allow an  unlimited number of games per
  78.     day to be played.
  79.  
  80.     Display All or High scores only:  In the  score file,  display all
  81.     scores or only each player's highest score. Setting this option to
  82.     'H' will limit  each player to  only one  entry  in the  score and
  83.     bulletin  files with  only their  highest single  game score being
  84.     shown. When set to 'A', all scores will be shown.
  85.  
  86.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  87.     bulletin file. If left blank no file will be written.
  88.  
  89.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  90.     Color) bulletin file.  If left blank no file will be written.
  91.  
  92.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  93.     communications support  that should be used.  Double Solitaire can
  94.     use either its own Internal communication routines or an installed
  95.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  96.     Internal  routines.  The Internal  communication routines  support
  97.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  98.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  99.     routines.
  100.  
  101.     Base Address  (COM1 through COM8):  If you are  using the Internal
  102.     communication routines on ports  other than  COM1 or COM2 you must
  103.     enter the Base Address of the ports, in hex, for the ports you are
  104.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  105.     changed.
  106.  
  107.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  108.     communication  routines on ports other  than COM1 or COM2 you must
  109.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  110.     COM1 and COM2 cannot be changed.
  111.  
  112.     After entering all of the  information, press 'ESC'. DBLSETUP will
  113.     ask if you want  to save the configuration  file.   If this is the
  114.     first  time  DBLSETUP  has  been  run  or  you have previously run
  115.     DBLSETUP but changed some of the information, press 'Y'. This will
  116.     will  create or  update the  configuration file  (DBLSOL.CFG).  It
  117.     will also create a DBLSOL.SCO  file if one does not exist. This is
  118.     the score file and is needed for the program to run.
  119.  
  120.     DBLSETUP will then ask if you want to create the registration file
  121.     (DBLSOL.REG).  The  registration  file  will be  needed  when  the
  122.     program is registered, so you will need to answer 'Y' at least one
  123.     time for this file to be created.  Please be sure all  information 
  124.     is correct as your 'Key Number' will be based on this information.
  125.  
  126.     Consult your BBS manual regarding the creation of DOOR batch files
  127.     for your BBS.  DBLSOL.EXE  must be  started  from the directory it
  128.     resides in for the game to function.  The command line for calling 
  129.     Double Solitaire is as follows:
  130.  
  131.     DBLSOL DBLSOL.CFG 'Full path and name of BBS information file'
  132.  
  133.     'Full path and name of BBS information file'
  134.  
  135.     This  will be the full path and filename of your  BBS  information 
  136.     file. For example: C:\PCB\PCBOARD.SYS.  Double Solitaire uses this
  137.     filename  to  determine the BBS software which is  being  used  as 
  138.     follows:
  139.  
  140.     CALLINFO.BBS (Wildcat 2.xx)
  141.     PCBOARD.SYS  (PCBoard)
  142.     DOOR.SYS     (GAP, Wildcat! 3.x and other systems using DOOR.SYS)
  143.     SFDOORS.DAT  (SPITFIRE)
  144.     DORINFOx.DEF (RA/QBBS/RBBS)
  145.  
  146.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  147.     fully compatible with RBBS.  By default, Double Solitaire uses the
  148.     RA/QBBS DORINFOx.DEF format.  If you are using the RBBS version of
  149.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  150.     command line in your calling batch file.
  151.  
  152.     An example of a batch file for PCBoard:
  153.  
  154.     CD\DBLSOL
  155.     DBLSOL DBLSOL.CFG C:\PCB\PCBOARD.SYS
  156.     CD\PCB
  157.     BOARD.BAT
  158.  
  159.     An example of a batch file for RBBS:
  160.  
  161.     CD\DBLSOL
  162.     DBLSOL DBLSOL.CFG C:\RBBS\DORINFO1.DEF /RBBS
  163.     CD\RBBS
  164.     BOARD.BAT
  165.  
  166.  
  167.     RIPSCRIP GRAPHICS
  168.     -----------------
  169.  
  170.     If the  caller  is using a  RIPscrip  compatible terminal,  Double
  171.     Solitaire  will  automatically detect  and use  RIPscrip  mode for
  172.     displaying  graphics.  The caller will also be  able to  use their
  173.     mouse in addition to the keyboard for playing the game.
  174.  
  175.     RIPscrip mode requires the icon files  JWCARD*.ICN be available on
  176.     the callers machine. If the caller does not have these files, they
  177.     will be asked  if they wish to  download them at  the start of the
  178.     game.  To do this you must have the files SEND.BAT and JWCARDS.ZIP
  179.     in the same directory as DBLSOL.EXE. SEND.BAT is a batch file that
  180.     calls DSZ (Omen Technology Inc) to send JWCARDS.ZIP  to the caller
  181.     using Zmodem.  Double Solitaire passes the base address and IRQ of
  182.     the com  port being used  so that  non-standard  com ports  may be
  183.     used.  If you  are using a  FOSSIL driver  or intelligent com port
  184.     card, you may have to replace DSZ in SEND.BAT with a Zmodem driver
  185.     compatible with your system.
  186.  
  187.     When the caller is in  RIPscrip mode a '(R)' will be  displayed on
  188.     the status line after the Node# to indicate RIPscrip mode is being
  189.     used on the  remote end.  ANSI graphics will be  displayed locally
  190.     when the caller is using RIPscrip.
  191.  
  192.  
  193.     UPGRADING
  194.     ---------
  195.  
  196.     To upgrade, replace the v1.0 DBLSOL.EXE, DBLSETUP.EXE, DSCARDS.ZIP
  197.     and  SEND.BAT  files  with  the  v1.1   DBLSOL.EXE,  DBLSETUP.EXE,
  198.     JWCARDS.ZIP and SEND.BAT files.  Note that DSCARDS.ZIP is not used
  199.     anymore and may be deleted. No other action is necessary.
  200.  
  201.  
  202.     ERRORS
  203.     ------
  204.  
  205.     Any  errors  which  may occur  will be  written to the  DBLSOL.ERR
  206.     file.  When possible, a descriptive error message will be  written 
  207.     to  DBLSOL.ERR  with the  exact cause of  the error. If the  error
  208.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS)  and
  209.     upload a copy of your DBLSOL.CFG, DBLSOL.SCO and DBLSOL.ERR files.
  210.     This will  allow  us to more quickly  determine  the cause  of the
  211.     error. All support is handled through the Gulf Coast BBS.
  212.  
  213.  
  214.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  215.     ------------------------------------
  216.  
  217.     Double Solitaire  has been  developed in a  networked environment.
  218.     All multi-node features have been  thoroughly tested on multi-node
  219.     systems using DESQview and  Peer-To-Peer Local Area Networks.  DOS
  220.     3.1+  full  record  and  file   locking  is  supported.   Multiple
  221.     configuration files are  NOT  necessary when running on multi-node
  222.     systems.
  223.         
  224.     Double Solitaire is DESQview aware.  It is automatically detected,
  225.     screen and  keyboard I/O are  "well behaved",  and time slices are
  226.     released back to other applications where appropriate.
  227.  
  228.  
  229.     MISCELLANEOUS
  230.     -------------
  231.  
  232.     At the  beginning of  each week the score  file will automatically
  233.     be cleared and last week's high scorer will be determined. The old
  234.     score file  will be saved in  DBLSOL.BAK.  This file is not needed
  235.     for normal operation of the program and may deleted if you desire.
  236.  
  237.     Double Solitaire uses a 'Tournament' style of play.  The cards are
  238.     shuffled so that each player's  game will be the same as all other
  239.     players.  Each player's first game  of the week will  use the same
  240.     sequence of cards as every other player's first game. Same for the
  241.     second game, etc. Each BBS will use a different sequence of cards.
  242.  
  243.     If you are using a high speed modem and have your com port LOCKED,
  244.     the  program will not respond to keyboard input while  your  modem 
  245.     buffer is full.  This is normal.
  246.  
  247.     Double Solitaire may be played from the DOS prompt by typing:
  248.  
  249.     DBLSOL DBLSOL.CFG LOCAL
  250.  
  251.     Note the user name is hard coded as 'SysOp' and that the bulletins
  252.     and score file will not be updated. This mode is only intended for
  253.     testing. The file LOCAL.BAT is included for this purpose.
  254.  
  255.     To turn on screen writing, if it is off, press any key.
  256.  
  257.  
  258.     REGISTRATION
  259.     ------------
  260.  
  261.     Registration is required if you choose to continue using this DOOR 
  262.     program.   After 60 days of running the program unregistered,  the 
  263.     score  file  will  cease to be updated.  However,  the  game  will 
  264.     continue  to allow players to play. This should be long enough  to 
  265.     determine if the program meets your needs and is popular with your 
  266.     users.
  267.  
  268.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  269.     with a 'Registered To:' message.  This will show the Name and  BBS 
  270.     Name from the DBLSOL.CFG file.
  271.  
  272.     There are two ways to register.
  273.  
  274.                         * Mail order Registration *
  275.  
  276.     If the DBLSOL.REG  form was not  previously  created, run DBLSETUP
  277.     and  have  it create  DBLSOL.REG.  Check this  file to  insure the
  278.     information is correct.  If it is not, re-run DBLSETUP and correct
  279.     any errors.   Your Key Number is based on the information in  this
  280.     file  and must be correct for your  Key Number to work.  Make sure
  281.     that the  Name and  BBS Name are  correct as displayed!  When done
  282.     print the form to your printer. Send the completed DBLSOL.REG form
  283.     along with your check, money order, VISA or MasterCard credit card
  284.     information for $15.00 (US) to:
  285.  
  286.                               J & W Software
  287.                           9426 N. China Pink Way
  288.                       Crystal River, FL  34428-9500
  289.  
  290.     Your personalized Key Number will be sent to you promptly. When it
  291.     is  received,  run  DBLSETUP  and  enter  your Key Number.  Double
  292.     Solitaire will then be registered. No other action is necessary.
  293.  
  294.  
  295.                      * Instant On-Line Registration *
  296.  
  297.     You may register  Double Solitaire  with  VISA or  MasterCard  and
  298.     receive  your  personalized  Key Number  instantly  by calling the
  299.     Gulf Coast BBS, (904) 563-2547, and entering  REGISTER at the main
  300.     menu prompt.  You will need the Name and BBS Name exactly as it is
  301.     entered on  lines 1 & 2  of  DBLSETUP  as well as your credit card
  302.     information to  register.  You  might  want  to make  note of this
  303.     information to speed  your call.  You will receive your Key Number
  304.     on that call.
  305.  
  306.  
  307.     WARRANTY & DISCLAIMER
  308.     ---------------------
  309.  
  310.     There  are  no warranties, express or  implied,  for  unregistered 
  311.     copies of Double Solitaire. The author will NOT be held liable for
  312.     any   direct,   indirect,   incidental,  or  consequential  damage
  313.     resulting from  the use of this program.  Your use of this program
  314.     constitutes your AGREEMENT to this disclaimer and your release  of 
  315.     the author from any form of liability.
  316.  
  317.     Registered copies of Double Solitaire are warranted  to perform as
  318.     described  in this  documentation.  In the event  Double Solitaire
  319.     does not  perform  as described,  the author will  elect to either
  320.     rectify  the   problem  or  refund   the  amount   paid,  provided
  321.     notification is received within 30 days of registration.
  322.  
  323.  
  324.                                  - END -
  325.