home *** CD-ROM | disk | FTP | other *** search
/ Season's Greetings & Games Unlimited / UGOLD_cd2.iso / klondike / klondike.doc < prev    next >
Text File  |  1992-04-11  |  37KB  |  888 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                       Klondike
  17.                                      version 3.1
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                          Copyright 1992 by Eduardo Martins
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                    _______
  44.                               ____|__     |                (r)
  45.                            --|       |    |-------------------
  46.                              |   ____|__  |  Association of
  47.                              |  |       |_|  Shareware
  48.                              |__|   o   |    Professionals
  49.                            -----|   |   |---------------------
  50.                                 |___|___|    MEMBER
  51.  
  52.  
  53.       Klondike User's Manual
  54.       -------------------------------------------------------------------------
  55.  
  56.  
  57.  
  58.  
  59.       INTRODUCTION
  60.       ============
  61.  
  62.  
  63.       Klondike, also known under a variety of local names such as Fascination
  64.       and China-Man, is probably the best known solitaire card game (actually,
  65.       many people are not aware of the fact that Klondike is just one of dozens
  66.       of solitaire games, and use the name 'Solitaire' to refer to it). There
  67.       are several implementations of Klondike available for MS-DOS machines,
  68.       but most of them have very crude graphics (when they do have graphics at
  69.       all!) and cumbersome user interfaces. This prompted me to write a version
  70.       that would take full advantage of high-resolution EGA graphics and was
  71.       intuitive and easy to use. Several months and a few thousand lines of
  72.       Turbo Pascal 4.0 source code later, Klondike 1.0 was released. User
  73.       response was very enthusiastic, and several users made suggestions that
  74.       were incorporated in later versions. This latest incarnation incorporates
  75.       a few more enhancements, and is generally regarded by its users as the
  76.       best solitaire card game available for the IBM PC and compatibles. I hope
  77.       you'll enjoy Klondike 3.1, and encourage the development of other
  78.       high-quality shareware programs by sending the registration fee together
  79.       with the enclosed registration form.
  80.  
  81.       A little plug: if you enjoy solitaire games, chances are you will like my
  82.       other games, Poker Solitaire (current version as of March 1992 is 2.1) and
  83.       Pyramid (current version is 1.1). They can be found on CompuServe (IBMNEW
  84.       Library 8 as PSOL21.EXE and PYRD11.EXE, respectively), GEnie (IBMPC
  85.       RoundTable Library 7 as PKRSOL21.EXE and PYRMID11.EXE), and on major
  86.       Bulletin Board Systems all over the country.
  87.  
  88.  
  89.  
  90.       SYSTEM REQUIREMENTS
  91.       ===================
  92.  
  93.  
  94.       Klondike 3.1 runs on an IBM-PC or compatible running under MS-DOS 2.1 or
  95.       greater, with an EGA/VGA monitor and display adapter and 384 Kbytes of
  96.       available memory. A Microsoft-compatible mouse is strongly recommended,
  97.       but the game can be played from the keyboard. If you want to use the
  98.       mouse, the mouse driver (usually called MOUSE.SYS or MOUSE.COM) must be
  99.       installed before you load Klondike; please refer to your mouse
  100.       documentation for instructions. Make sure that the files KLONDIKE.EXE,
  101.       KLONDIKE.GX, and KLONDIKE.HLP are all on the current directory. If you
  102.       are running Klondike from a floppy disk, make sure that the disk is not
  103.       write-protected, since the program writes configuration information to
  104.       disk.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                                           1
  111.  
  112.  
  113.       Klondike User's Manual
  114.       -------------------------------------------------------------------------
  115.  
  116.  
  117.       KLONDIKE RULES
  118.       ==============
  119.  
  120.  
  121.       One regular pack of 52 cards is used. Deal 28 cards into 7 piles. The
  122.       first pile at the left has one card, the second two, and so on, up to
  123.       seven in the last pile. The top card of each pile is face up; all the
  124.       rest are face down. On the piles you may build in descending sequence,
  125.       red on black or black on red. For example, on the 8 of spades you can
  126.       place either the 7 of hearts or the 7 of diamonds. All the face up cards
  127.       on a pile may be moved as a unit, and matched according to the bottom
  128.       card. When you uncover a face down card on a pile, turn it face up. If
  129.       one pile is entirely removed, you may put a king in the space. Each time
  130.       you free an ace, move it to the Foundation, a row above the piles. On the
  131.       Foundation you build up in suit and sequence. For example, the 2 of
  132.       hearts may be placed on the Ace of hearts, the 3 of hearts may be placed
  133.       over the 2 of hearts, and so on. To win the game, you have to build each
  134.       Foundation up to the king. Once placed on the Foundation, a card cannot
  135.       be moved anywhere else. From the rest of the pack, turn up cards one by
  136.       one. Put cards that you cannot use into a waste pile. You can always use
  137.       the top card of the waste pile. You may go through the pack only once.
  138.       The game ends either when you win by building each Foundation up to the
  139.       king, or when your moves reach a standstill.
  140.  
  141.  
  142.       Variations
  143.  
  144.  
  145.       Klondike, as played by its original rules, is very hard to win (it has
  146.       been estimated that the chances of winning are one in every thirty
  147.       games!) and thus can be a bit frustrating.  Two popular variations
  148.       greatly increase the odds of winning. Under the first variation, cards
  149.       are moved from the Pack to the Waste Pile in groups of three, and you can
  150.       go through the Pack as many times as you wish, i.e., once the Pack is
  151.       exhausted, you move all the cards from the Waste Pile back to the Pack.
  152.       Under the second variation, cards are turned up from the Pack one by one,
  153.       as in the original rules, but you can go through the Pack an unlimited
  154.       number of times, as in the first variation. This is the easiest of all
  155.       three playing modes.
  156.  
  157.       Under the original Klondike rules, you must move all face-up cards on a
  158.       pile as a unit (except when you are moving from the pile to the
  159.       Foundation, in which case you move the top card of the pile alone).
  160.       Klondike 2.3 has a relaxed movement rule. Under it, you can move all
  161.       face-up cards as a unit; the top card alone, or any contiguous block of
  162.       cards beginning at the top card. Suppose you have a pile with a 4-5-6-7-8
  163.       face-up. If you're using the relaxed movement rule, you can move all five
  164.       cards as a unit, or the 4-5-6-7 block, or the 4-5-6, or 4-5, or the 4
  165.       alone. Through skillful manipulation of the cards, you can free cards
  166.       that would otherwise be unavailable, and win games that would be
  167.       unwinnable under the regular rules. This makes the game more challenging,
  168.       because it gives you a greater chance of winning against a bad deal.
  169.  
  170.                                           2
  171.  
  172.  
  173.       Klondike User's Manual
  174.       -------------------------------------------------------------------------
  175.  
  176.  
  177.       The currently selected variation is displayed on the top of the screen,
  178.       below the Pass number. The first character is either a 0, 1 or 2, and
  179.       represents the variation number, and the second character is either an S
  180.       or R, for Strict and Relaxed movement rules, respectively.
  181.  
  182.  
  183.       SCORING
  184.       =======
  185.  
  186.       Klondike 3.1 uses Vegas-style scoring. You pay $50 for the deck, and get
  187.       $5 back for each card you are able to place on the Foundation piles.
  188.       Under variations 1 and 2, you can go thru the Pack multiple times, but
  189.       you lose $3 for each extra pass on variation 1 and $10 for each extra
  190.       pass on variation 2. Note that you cannot lose more than the initial $50;
  191.       so, if your score is already -$50, you won't lose anything for extra
  192.       passes.
  193.  
  194.       The maximum possible score is $210 (52 cards in the Foundation piles at
  195.       $5 each, minus $50 for the deck). If you win the game in a single pass
  196.       thru the deck, you receive a $90 bonus, for a score of $300.
  197.  
  198.  
  199.       TOP TEN AND CAREER STATISTICS
  200.       =============================
  201.  
  202.       A Top Ten list is kept for each variation (thus there are three different
  203.       Top Ten lists). You can change variations in the middle of a game, but
  204.       note that if you do change variations after you have moved a card from
  205.       the Pack, the variation that will be used for Top Ten purposes will be
  206.       the easiest one selected during the game, variation 0 being the hardest
  207.       and variation 2 the easiest. When you view the Top Ten list during a
  208.       game, the list displayed will be the one for the easiest variation
  209.       selected at any time after the first card from the Pack was moved,
  210.       regardless of the variation you have currently selected. The Top Ten
  211.       lists are kept on a file called KLONDIKE.TOP. To reset the Top Ten
  212.       lists, simply delete this file.
  213.  
  214.       Career statistics are kept for each player, including the number of games
  215.       played, number of games won, total earnings (or losses), and average
  216.       earnings (or losses) per game. They are kept on a file called
  217.       KLONDIKE.SCO. If KLONDIKE.SCO is not found on the current directory, a
  218.       new one will be created.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.                                           3
  231.  
  232.  
  233.       Klondike User's Manual
  234.       -------------------------------------------------------------------------
  235.  
  236.  
  237.       GAME PLAY - MOUSE
  238.       =================
  239.  
  240.  
  241.       To move a card, first place the mouse cursor over the card (or pile) you
  242.       want to move and press the left mouse button (the selected card will be
  243.       highlighted), then place the cursor over where you want to put the card
  244.       (or pile) and press the left button again. If you select a card to be moved and decide
  245.       not to move that card, simply select it again to cancel the move command.
  246.       To move a card from the Deck to the Waste Pile, press the right mouse
  247.       button.
  248.  
  249.       If a card is face down, just place the mouse cursor over it and press the
  250.       left mouse button to turn the card face up.
  251.  
  252.       At the beginning of each session, you are prompted to enter your name.
  253.       The name used in the previous session is offered as a default. Press any
  254.       mouse button to accept that name, or just type in a new name (there's no
  255.       need to erase the old one, as soon as you type any letter it will be
  256.       erased for you). You can change the name at any time during a session by
  257.       placing the mouse cursor inside the box that displays the current
  258.       player's name and score and clicking the left mouse button. You will then
  259.       be prompted to enter a new name. Note that this is the only way to change
  260.       the name other than quitting the game and starting a new one.
  261.  
  262.       The following commands are available during play, and can be issued by
  263.       placing the mouse cursor over the corresponding 'command button' (on the
  264.       lower right hand corner of the screen) and pressing the left mouse
  265.       button:
  266.  
  267.          UNDO: undoes the last successful move executed. UNDO cannot be used
  268.          after a FINISH or another UNDO command.
  269.  
  270.          FINISH: automatically moves all cards that can legally be moved from
  271.          the Tableau and the Waste Pile to the Foundation. Caution: you cannot
  272.          undo a FINISH command!
  273.  
  274.          HELP: displays a help file. Use the cursor keys (Up, Down, PgUp, PgDn,
  275.          Home, and End) to move around the file, and press [Esc] when you are
  276.          done viewing it.
  277.  
  278.          PEEK: shows all the face-down cards in the piles, and then all the
  279.          Pack and Waste cards, if any.
  280.  
  281.  
  282.          TOP TEN: shows the Top Ten list, and then the career statistics for
  283.          the current player. The career statistics window shows the total
  284.          number of games played, number of games won, percentage of games won,
  285.          total career earnings (or losses), and average earnings (or losses)
  286.          per game.
  287.  
  288.  
  289.  
  290.                                           4
  291.  
  292.  
  293.       Klondike User's Manual
  294.       -------------------------------------------------------------------------
  295.  
  296.          RULES: allows you to select which variation you want to play. Choose
  297.          the variation by placing the mouse cursor over the number you want and
  298.          pressing the left mouse button. Press the right mouse button when
  299.          done. The currently selected variation is highlighted. You can then
  300.          choose either the strict or relaxed movement rule. Place the mouse
  301.          cursor over the desired rule and press the left mouse button, and
  302.          press the right mouse button when done.
  303.  
  304.          BACK: allows you to choose from five different card backs. Choose the
  305.          design you want by placing the mouse cursor over it and pressing the
  306.          left mouse button. Press the right mouse button when done. The
  307.          currently selected card number is highlighted in light blue.
  308.  
  309.          CONFIG: brings up the Configuration menu. This allows you to customize
  310.          your copy of Klondike. The first option, Mouse, can be set to 'Yes'
  311.          (always use the mouse; this option is ignored if a mouse driver is not
  312.          found when you start Klondike), 'No' (always use the keyboard, even if
  313.          a mouse driver is present), or 'Ask' (if a mouse driver is found, asks
  314.          at the beginning of each game whether or not you want to use the
  315.          mouse). The second option, Sound, can be set to 'Full' (songs and
  316.          beeps are enabled), 'Partial' (songs disabled, but error beeps
  317.          enabled), or 'Off' (both songs and beeps disabled). Finally, the third
  318.          option, Error Messages, can be set to 'Yes' (displays a
  319.          context-sensitive error message each time an error occurs), or 'No'
  320.          (does not display the error messages, errors are indicated by beeps if
  321.          Sound is either Full or Partial). To select an option, place the mouse
  322.          cursor over it and press the left mouse button. Currently selected
  323.          options are highlighted. Press the right mouse button when done. If
  324.          you are playing from a floppy-disk, do NOT write-protect the disk,
  325.          otherwise Config will not be able to write the configuration
  326.          information.
  327.  
  328.          INFO: displays Copyright and Version information, and your
  329.          registration number if you have a registered copy. Press any mouse
  330.          button to return to the game after you are done viewing the
  331.          information.
  332.  
  333.          NEW: interrupts the current game and starts a new one. You are asked
  334.          to confirm by selecting either 'Yes' or 'No' from a dialog box. Use
  335.          the left mouse button to enter your selection.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.                                           5
  351.  
  352.  
  353.       Klondike User's Manual
  354.       -------------------------------------------------------------------------
  355.  
  356.  
  357.          QUIT: quits Klondike. You are asked to confirm by selecting 'Yes',
  358.          'No' or 'Ignore' from a dialog box. Use the left mouse button to enter
  359.          your selection. 'Yes' will quit the game and add the score to your
  360.          career statistics file, 'No' will get you back to the current game,
  361.          and 'Ignore' will quit and ignore the current score.
  362.  
  363.  
  364.       If you are using Variation 1 or Variation 2, press the right mouse button
  365.       after the Pack is exhausted (as if you were moving one more card from the
  366.       Pack to the Waste) and the Waste will be moved back to the Pack. The
  367.       appropriate amount ($3 if using Variation 1, $10 if using variation 2)
  368.       will be deducted from your score.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.                                           6
  411.  
  412.  
  413.       Klondike User's Manual
  414.       -------------------------------------------------------------------------
  415.  
  416.  
  417.       GAME PLAY - KEYBOARD
  418.       ====================
  419.  
  420.  
  421.       To Move a card, first press the key corresponding to the Origin (the
  422.       selected card will be highlighted), then press the key corresponding to
  423.       the Destination. For example, to move from the Pack to pile 1, press [P]
  424.       then [1]. Valid Origins are 1 to 7, P, and W. Valid Destinations are 1 to
  425.       7, W, and F. If you select a card to be moved and decide not to move that
  426.       card, press the Esc key to cancel the move command.
  427.  
  428.       If a card is face down, press the key corresponding to that card and it
  429.       will be turned face up. You can turn only the first card of the Pack and
  430.       cards on the Tableau (1 to 7) that are face down.
  431.  
  432.       At the beginning of each session, you are prompted to enter your name.
  433.       The name used in the previous session is offered as a default. Press the
  434.       [Enter] key to accept that name, or just type in a new name (there's no
  435.       need to erase the old one, as soon as you type any letter it will be
  436.       erased for you). You can change the name at any time during a session by
  437.       pressing [Ctrl][N]. You will then be prompted to enter a new name. Note
  438.       that this is the only way to change the name other than quitting the game
  439.       and starting a new one.
  440.  
  441.       Note that the NumLock option is automatically turned on when you play
  442.       using the keyboard. You can then use the numeric keypad to play. The
  443.       keypad keys work as indicated below:
  444.  
  445.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ +------+
  446.       |      | |      | |      | |      |  |      | |      | |      | |-     |
  447.       |      | |      | |      | |      |  |      | |      | |      | |Quit  |
  448.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ +------+
  449.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ +------+
  450.       |7     | |8     | |9     | |PrtSc |  |7     | |8     | |9     | |+     |
  451.       |Pile 7| |Pack  | |Waste | |New   |  |Pile 7| |Pack  | |Waste | |      |
  452.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ |      |
  453.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ |      |
  454.       |4     | |5     | |6     | |-     |  |4     | |5     | |6     | |      |
  455.       |Pile 4| |Pile 5| |Pile 6| |Quit  |  |Pile 4| |Pile 5| |Pile 6| |Finish|
  456.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ +------+
  457.       +------+ +------+ +------+ +------+  +------+ +------+ +------+ +------+
  458.       |1     | |2     | |3     | |+     |  |1     | |2     | |3     | |Enter |
  459.       |Pile 1| |Pile 2| |Pile 3| |      |  |Pile 1| |Pile 2| |Pile 3| |      |
  460.       +------+ +------+ +------+ |      |  +------+ +------+ +------+ |      |
  461.       +---------------+ +------+ |      |  +---------------+ +------+ |      |
  462.       |0              | |.     | |      |  |0              | |.     | |      |
  463.       |Foundation     | |Undo  | |Finish|  |Foundation     | |Undo  | |New   |
  464.       +---------------+ +------+ +------+  +---------------+ +------+ +------+
  465.  
  466.             Standard AT keyboard                  Enhanced keyboard
  467.  
  468.  
  469.  
  470.                                           7
  471.  
  472.  
  473.       Klondike User's Manual
  474.       -------------------------------------------------------------------------
  475.  
  476.  
  477.       The following commands are available during play, and can be issued by
  478.       typing the highlighted letter from the corresponding 'command button' (on
  479.       the lower right hand corner of the screen):
  480.  
  481.          UNDO: undoes the last successful move executed. UNDO cannot be used
  482.          after a FINISH or another UNDO command.
  483.  
  484.          FINISH: automatically moves all cards that can legally be moved from
  485.          the Tableau and the Waste Pile to the Foundation. Caution: you cannot
  486.          undo a FINISH command!
  487.  
  488.          HELP: displays a help file. Use the cursor keys (Up, Down, PgUp, PgDn,
  489.          Home, and End) to move around the file, and press [Esc] when you are
  490.          done viewing it.
  491.  
  492.          PEEK: shows all the face-down cards in the piles, and then all the
  493.          Pack and Waste cards, if any.
  494.  
  495.          TOP TEN: shows the Top Ten list, and then the career statistics for
  496.          the current player. The career statistics window shows the total
  497.          number of games played, number of games won, percentage of games won,
  498.          total career earnings (or losses), and average earnings (or losses)
  499.          per game.
  500.  
  501.          RULES: allows you to select which variation you want to play. Choose
  502.          the variation by typing the corresponding number. Press [Enter] when
  503.          done. The currently selected variation is highlighted. You can then
  504.          choose either the strict or relaxed movement rule. Press either [S]
  505.          for strict or [R] for relaxed, and press [Enter] when done.
  506.  
  507.          BACK: allows you to choose from five different card backs. Choose the
  508.          design you want by pressing the corresponding number, and press
  509.          [Enter] when done. The currently selected card number is displayed in
  510.          light blue.
  511.  
  512.          CONFIG: brings up the Configuration menu. This allows you to customize
  513.          your copy of Klondike. The first option, Mouse, can be set to 'Yes'
  514.          (always use the mouse; this option is ignored if a mouse driver is not
  515.          found when you start Klondike), 'No' (always use the keyboard, even if
  516.          a mouse driver is present), or 'Ask' (if a mouse driver is found, asks
  517.          at the beginning of each game whether or not you want to use the
  518.          mouse). The second option, Sound, can be set to 'Full' (songs and
  519.          beeps are enabled), 'Partial' (songs disabled, but error beeps
  520.          enabled), or 'Off' (both songs and beeps disabled). Finally, the third
  521.          option, Error Messages, can be set to 'Yes' (displays a
  522.          context-sensitive error message each time an error occurs), or 'No'
  523.          (does not display the error messages, errors are indicated by beeps if
  524.          Sound is either Full or Partial). You will be prompted to enter the
  525.          desired option for Mouse, Sound and Error Messages, in that order.
  526.          Press either [Y], [N] or [A] for Mouse; [F], [P] or [O] for Sound; and
  527.          [Y] or [N] for Error Messages. Press [Enter] after selecting each one.
  528.  
  529.  
  530.                                           8
  531.  
  532.  
  533.       Klondike User's Manual
  534.       -------------------------------------------------------------------------
  535.  
  536.  
  537.          Currently selected options are highlighted. If you are playing from a
  538.          floppy-disk, do NOT write-protect the disk, otherwise Config will not
  539.          be able to write the configuration information.
  540.  
  541.          INFO: displays Copyright and Version information, and your
  542.          registration number if you have a registered copy. Press any key to
  543.          return to the game after you are done viewing the information.
  544.  
  545.          NEW: interrupts the current game and starts a new one. You are asked
  546.          to confirm by selecting either 'Yes' or 'No' from a dialog box. Press
  547.          either [Y] or [N] to enter your selection.
  548.  
  549.          QUIT: quits Klondike. You are asked to confirm by selecting 'Yes',
  550.          'No' or 'Ignore' from a dialog box. Press [Y], [N] or [I] to enter
  551.          your selection. 'Yes' will quit the game and add the score to your
  552.          career statistics file, 'No' will get you back to the current game,
  553.          and 'Ignore' will quit and ignore the current score.
  554.  
  555.  
  556.       If you are using Variation 1 or Variation 2, press P after the Pack is
  557.       exhausted (as if you were moving one more card from the Pack to the
  558.       Waste) and the Waste will be moved back to the Pack. The appropriate
  559.       amount ($3 if using Variation 1, $10 if using variation 2) will be
  560.       deducted from your score.
  561.  
  562.  
  563.  
  564.       COMMAND-LINE OPTIONS
  565.       ====================
  566.  
  567.       The following options can be specified when you load Klondike:
  568.  
  569.  
  570.       -mouse        selects the mouse as the input device. This option is
  571.                     ignored if a mouse driver is not found.
  572.  
  573.       -nomouse      selects the keyboard as the input device.
  574.  
  575.       -ask          asks whether or not you want to use the mouse. This option
  576.                     is ignored if a mouse driver is not found. [Default]
  577.  
  578.       -fullsound    turns full sound (songs and error beeps) on. [Default]
  579.  
  580.       -partsound    turns partial sound (error beeps, but no songs) on.
  581.  
  582.       -nosound      turns both songs and error beeps off.
  583.  
  584.       -var[n]       selects Variation [n], where [n] is a number from 0 to 2.
  585.                     [Default is -var0]
  586.  
  587.  
  588.  
  589.  
  590.                                           9
  591.  
  592.  
  593.       Klondike User's Manual
  594.       -------------------------------------------------------------------------
  595.  
  596.  
  597.       -strict       selects the Strict movement rule. [Default]
  598.  
  599.       -relaxed      selects the Relaxed movement rule.
  600.  
  601.       -back[n]      selects card back [n], where [n] is a number from 1 to 5.
  602.                     [Default is -back1]
  603.  
  604.       -errormsgon   turns error messages on. [Default]
  605.  
  606.       -errormsgoff  turns error messages off.
  607.  
  608.       Note that the command-line switches have precedence over the settings
  609.       selected through the Config command. So, if you have Klondike currently
  610.       configured to use card back 2 and the relaxed movement rule, but you load
  611.       it as
  612.  
  613.               klondike -back5 -strict
  614.  
  615.       card back 5 and the strict movement rule will be used.
  616.  
  617.  
  618.       REGISTRATION
  619.       ============
  620.  
  621.       You are granted a license to try this program for a period of 21 days. If
  622.       you continue to use it after the trial period is over, you must register
  623.       by sending the registration form and $15 plus $5 shipping and handling to
  624.       
  625.                                     EM Software
  626.                               Station A  P.O. Box 2052
  627.                              Champaign, IL  61825-2052
  628.  
  629.       You will receive a disk with the latest version and a printed manual.
  630.       When you register Klondike, you receive a registration number and
  631.       instructions on how to store it into your copy. This number will then be
  632.       displayed instead of the 'Unregistered Evaluation Copy' message on the
  633.       opening screen and on the Info window, and the Shareware screen that is
  634.       displayed after you quit the game will be supressed.
  635.  
  636.       Note that, except for the differences listed above, the evaluation and
  637.       the registered copies are identical. The evaluation copy is fully
  638.       functional.
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.                                           10
  651.  
  652.  
  653.       Klondike User's Manual
  654.       -------------------------------------------------------------------------
  655.  
  656.  
  657.       TECHNICAL SUPPORT
  658.       =================
  659.  
  660.       If you have any questions or comments about Klondike, please write to
  661.  
  662.  
  663.                                   EM Software
  664.                            Station A, P.O. Box 2052
  665.                            Champaign, IL  61825-2052
  666.  
  667.  
  668.       or leave electronic mail to 73300,267 on CompuServe or E.MARTINS on
  669.       GEnie.
  670.  
  671.       While I have made every effort to ensure that this software works
  672.       properly, I know better than to claim that you will never experience
  673.       problems while using it. If you believe you have found a bug, please
  674.       report it in as much detail as possible, including a reproducible
  675.       sequence of events that leads to the problem, a complete description of
  676.       your hardware (including mouse manufacturer and mouse driver version
  677.       number), DOS version used, amount of free memory reported by CHKDSK, and
  678.       a copy of your CONFIG.SYS and AUTOEXEC.BAT files.
  679.  
  680.  
  681.       NOTES FOR USERS OF PREVIOUS VERSIONS
  682.       ====================================
  683.  
  684.       Version 2.1 and below
  685.  
  686.       *  When using the mouse, you no longer have to press the right button to
  687.          finish moving a card. Simply press the left button again and the move
  688.          will be made. Press the right button to move a card from the Pack to
  689.          the Waste Pile. You can still place the cursor over the Pack, click
  690.          the left button, then place the cursor over the Waste Pile, and click
  691.          the left button again, but it is obviously a lot easier just to click
  692.          the right button (the cursor doesn't even have to be over the Pack).
  693.  
  694.       *  The RE-USE command is gone. After the Pack is exhausted, simply press
  695.          the right mouse button (as if you were moving one more card from the
  696.          Pack to the Waste) and the Waste will be moved back to the Pack
  697.          (assuming, of course, that you are using either variation 1 or 2). If
  698.          you're playing from the keyboard, press P (for Pack) instead.
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.                                           11
  710.  
  711.  
  712.       Klondike User's Manual
  713.       -------------------------------------------------------------------------
  714.  
  715.  
  716.  
  717.       *  A new Registration procedure has been added. After you register, you
  718.          will receive a registration number and instructions on how to 'burn
  719.          it' into your Klondike copy. This number will then be displayed when
  720.          you issue the INFO command, and the Shareware screen that is displayed
  721.          on unregistered copies will be suppressed. Note that these are the
  722.          ONLY differences between registered and unregistered copies; the
  723.          evaluation copy is fully functional, and is not crippled in ANY way.
  724.  
  725.  
  726.       Version 2.2
  727.  
  728.       *  The top card of the Pack is now ALWAYS face down. When you 'click' on
  729.          the Pack, the cards are automatically moved to the Waste pile, either
  730.          one or three at a time, depending on which rule set you are using. The
  731.          top card of the Waste pile is always available for play. This conforms
  732.          more closely to the 'official' Klondike rules.
  733.  
  734.       *  An UNDO command has been added. You can now undo your LAST move. Undo
  735.          can only be used after a SUCCESSFUL move command, i.e., after you have
  736.          successfully moved a card from one location to another. It CANNOT be
  737.          used after you turn a card face up, or use the FINISH command.
  738.  
  739.       *  A NEW (for New Game) command has been included. To quit the current
  740.          game and start a new one, simply click the NEW button. You'll be asked
  741.          to confirm your choice, and, if you reply 'yes', a new game will be
  742.          started. The QUIT command now does NOT ask whether you want to play
  743.          again, since you can start a new game directly from NEW. This saves
  744.          keystrokes both when quitting the game and when starting a new one.
  745.  
  746.       *  The FINISH command now moves cards from the Waste pile to the
  747.          Foundations.
  748.  
  749.  
  750.       *  The Help system was completely rewritten. Now, instead of viewing a
  751.          single Help screen, you can browse through a much longer and more
  752.          detailed Help file. Error handling was greatly enhanced, and you now
  753.          get an Error Message telling WHY a particular move cannot be made
  754.          (this can be optionally turned off either through the CONFIG command
  755.          or through the -nomessage command line option).
  756.  
  757.  
  758.       Version 2.3
  759.  
  760.       *  Vegas-style scoring was added, with Top Ten lists and career
  761.          statistics for each player.
  762.  
  763.       *  A PEEK command, which lets you see the face down cards in the Piles
  764.          and the remaining cards on the Pack and Waste, was added.
  765.  
  766.       *  New card layout, with the face down cards on the Piles represented as
  767.          a tiered stack.
  768.  
  769.                                           12
  770.  
  771.  
  772.       Klondike User's Manual
  773.       -------------------------------------------------------------------------
  774.  
  775.  
  776.       Version 3.0
  777.  
  778.       * The mouse routines have been totally rewritten. The problem with 
  779.         jerky mouse response when using certain mouse drivers has been
  780.         eliminated.
  781.  
  782.       * The file KLONDIKE.PCL has been replaced by KLONDIKE.GX.
  783.  
  784.       * The mouse cursor no longer changes to a pointing hand when placed
  785.         over the piles or over the stack and waste cards.
  786.  
  787.  
  788.       ACKNOWLEDGEMENTS
  789.       ================
  790.  
  791.  
  792.       Klondike was written using Borland's Turbo Pascal 5.0, Turbo Power
  793.       Software's Turbo Professional 5.0, and Genus Microcomputing's PCX
  794.       Programmer's Toolkit and PCX Effects.
  795.  
  796.       I wish to thank everybody at CompuServe's Borland (BPROGA) Forum. Their
  797.       help and support has been invaluable. I also wish to thank the following
  798.       individuals:
  799.  
  800.       *  Neil Rubenking, author of PianoMan, used to add the title and
  801.          congratulation screen songs;
  802.  
  803.       *  Scott Bussinger, author of the BackPlay unit, used to play the
  804.          PianoMan tunes in the background;
  805.  
  806.       *  Tim Godfrey, author of the GrafText unit, used for the extremely fast
  807.          graphics-mode screen writes;
  808.  
  809.       *  and, last but not least, all the users and friends who beta-tested
  810.          Klondike and made significant contributions, especially Mael Martins,
  811.          John Middleton, David L. Blair, Karl Zero, and Bill Mullin, and the
  812.          'Bug Busters' - Angel Cruz, Tom Canaday, Neil Rubenking, Joan
  813.          Friedman, Howard Silverman, Diane Clayton, Martin Schiff, Marilyn
  814.          Ratcheson, and Keith Brown, the toughest beta-test team I could ever
  815.          hope for!.
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.                                           13
  828.  
  829.  
  830.       Klondike User's Manual
  831.       -------------------------------------------------------------------------
  832.  
  833.  
  834.  
  835.       ABOUT SHAREWARE
  836.       ===============
  837.  
  838.  
  839.       (Definition supplied by the Association of Shareware Professionals)
  840.  
  841.  
  842.       Shareware distribution gives users a chance to try software before buying
  843.       it. If you try a Shareware program and continue using it, you are
  844.       expected to register. Individual programs differ on details -- some
  845.       request registration while others require it, some specify a maximum
  846.       trial period. With registration, you get anything from the simple right
  847.       to continue using the software to an updated program with a printed
  848.       manual.
  849.  
  850.       Copyright laws apply to both Shareware and commercial software, and the
  851.       copyright holder retains all rights, with a few specific exceptions as
  852.       stated below. Shareware authors are accomplished programmers, just like
  853.       commercial authors, and the programs are of comparable quality. (In both
  854.       cases, there are good programs and bad ones!) The main difference is in
  855.       the method of distribution. The author specifically grants the right to
  856.       copy and distribute the software, either to all and sundry or to a
  857.       specific group. For example, some authors require written permission
  858.       before a commercial disk vendor may copy their Shareware.
  859.  
  860.       So, Shareware is a distribution method, not a type of software. You
  861.       should find software that suits your needs and pocketbook, whether it's
  862.       commercial or Shareware. The Shareware system makes fitting your needs
  863.       easier, because you can try before you buy. And because the overhead is
  864.       low, prices are low also. Shareware has the ultimate money-back guarantee
  865.       -- if you don't use the product, you don't pay for it.
  866.  
  867.  
  868.                                       * * * * *
  869.  
  870.  
  871.       This program is produced by a member of the Association of Shareware
  872.       Professionals (ASP). ASP wants to make sure that the shareware principle
  873.       works for you. If you are unable to resolve a shareware-related problem
  874.       with an ASP member by contacting the member directly, ASP may be able to
  875.       help. The ASP Ombudsman can help you resolve a dispute or problem with an
  876.       ASP member, but does not provide technical support for members' products.
  877.       Please write to the ASP Ombudsman at 545 Grover Road, Muskegon,
  878.       MI  49442-9247, or send a Compuserve message via CMAIL to 
  879.       ASP Ombudsman 70007,3536.
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.                                           14
  888.