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