home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Devil's Doorknob BBS Capture (1996-2003)
/
devilsdoorknobbbscapture1996-2003.iso
/
Dloads
/
SYSOP
/
KLONDK23.ZIP
/
KLONDIKE.DOC
next >
Wrap
Text File
|
1989-09-29
|
34KB
|
859 lines
Klondike
version 2.3
Copyright (C) 1989 by Eduardo Martins
_______
____|__ | (tm)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Klondike User's Manual
-------------------------------------------------------------------------
INTRODUCTION
============
Klondike, also known under a variety of local names such as Fascination
and China-Man, is probably the best known solitaire card game (actually,
many people are not aware of the fact that Klondike is just one of dozens
of solitaire games, and use the name 'Solitaire' to refer to it). There
are several implementations of Klondike available for MS-DOS machines,
but most of them have very crude graphics (when they do have graphics at
all!) and cumbersome user interfaces. This prompted me to write a version
that would take full advantage of high-resolution EGA graphics and was
intuitive and easy to use. Several months and a few thousand lines of
Turbo Pascal 4.0 source code later, Klondike 1.0 was released. User
response was very enthusiastic, and several users made suggestions that
were incorporated in later versions. This latest incarnation incorporates
a few more enhancements, and is generally regarded by its users as the
best solitaire card game available for the IBM PC and compatibles. I hope
you'll enjoy Klondike 2.3, and encourage the development of other high-
quality shareware programs by sending the registration fee together with
the enclosed registration form.
A little plug: if you enjoy solitaire games, chances are you will like my
other games, Poker Solitaire (current version as of September 1989 is
2.0) and Pyramid (to be released on October 1989). They can be found on
CompuServe (IBMNEW Library 6), GEnie (IBMPC RoundTable), and on major
Bulletin Board Systems all over the country, or you can get a diskette
with the latest versions directly from me by sending a $5 check. Note
that the $5 are only to cover the diskette and mailing costs, each pro-
gram has a registration fee of $15 (registration only) or $20 (registra-
tion, latest version on disk, and printed manual).
SYSTEM REQUIREMENTS
===================
Klondike 2.3 runs on an IBM-PC or compatible running under MS-DOS 2.0 or
greater, with an EGA/VGA monitor and display adapter and 256 Kbytes of
available memory. A Microsoft-compatible mouse is strongly recommended,
but the game can be played from the keyboard. If you want to use the
mouse, the mouse driver (usually called MOUSE.SYS or MOUSE.COM) must be
installed before you load Klondike; please refer to your mouse documenta-
tion for instructions. Make sure that the files KLONDIKE.EXE, KLONDI-
KE.PCL, and KLONDIKE.HLP are all on the current directory. If you are
running Klondike from a floppy disk, make sure that the disk is not
write-protected, since the program writes configuration information to
disk.
1
Klondike User's Manual
-------------------------------------------------------------------------
KLONDIKE RULES
==============
One regular pack of 52 cards is used. Deal 28 cards into 7 piles. The
first pile at the left has one card, the second two, and so on, up to
seven in the last pile. The top card of each pile is face up; all the
rest are face down. On the piles you may build in descending sequence,
red on black or black on red. For example, on the 8 of spades you can
place either the 7 of hearts or the 7 of diamonds. All the face up cards
on a pile may be moved as a unit, and matched according to the bottom
card. When you uncover a face down card on a pile, turn it face up. If
one pile is entirely removed, you may put a king in the space. Each time
you free an ace, move it to the Foundation, a row above the piles. On the
Foundation you build up in suit and sequence. For example, the 2 of
hearts may be placed on the Ace of hearts, the 3 of hearts may be placed
over the 2 of hearts, and so on. To win the game, you have to build each
Foundation up to the king. Once placed on the Foundation, a card cannot
be moved anywhere else. From the rest of the pack, turn up cards one by
one. Put cards that you cannot use into a waste pile. You can always use
the top card of the waste pile. You may go through the pack only once.
The game ends either when you win by building each Foundation up to the
king, or when your moves reach a standstill.
Variations
Klondike, as played by its original rules, is very hard to win (it has
been estimated that the chances of winning are one in every thirty
games!) and thus can be a bit frustrating. Two popular variations
greatly increase the odds of winning. Under the first variation, cards
are moved from the Pack to the Waste Pile in groups of three, and you can
go through the Pack as many times as you wish, i.e., once the Pack is
exhausted, you move all the cards from the Waste Pile back to the Pack.
Under the second variation, cards are turned up from the Pack one by one,
as in the original rules, but you can go through the Pack an unlimited
number of times, as in the first variation. This is the easiest of all
three playing modes.
Under the original Klondike rules, you must move all face-up cards on a
pile as a unit (except when you are moving from the pile to the Founda-
tion, in which case you move the top card of the pile alone). Klondike
2.3 has a relaxed movement rule. Under it, you can move all face-up cards
as a unit; the top card alone, or any contiguous block of cards beginning
at the top card. Suppose you have a pile with a 4-5-6-7-8 face-up. If
you're using the relaxed movement rule, you can move all five cards as a
unit, or the 4-5-6-7 block, or the 4-5-6, or 4-5, or the 4 alone. Through
skillful manipulation of the cards, you can free cards that would other-
wise be unavailable, and win games that would be unwinnable under the
regular rules. This makes the game more challenging, because it gives you
a greater chance of winning against a bad deal.
2
Klondike User's Manual
-------------------------------------------------------------------------
GAME PLAY - MOUSE
=================
To move a card, first place the mouse cursor over the card (or pile) you
want to move and press the left mouse button, then place the cursor over
where you want to put the card (or pile) and press the left button again.
Notice that the cursor changes to a pointing hand whenever it is over a
card or pile that can be moved. After you select the card (or pile) to
move by pressing the left mouse button, the cursor changes to an hour-
glass to indicate that it is waiting for you to enter the destination of
the move. Whenever you place it over a location that could be used as a
destination, it will change from the hourglass back to a pointing hand
(note that this does not check for a valid move. It merely tells you that
you could move a card from pile 1 to pile 5, if the cards match, but that
you could never move a card from pile 1 to the waste pile). If you select
a card to be moved and decide not to move that card, press both mouse
buttons simultaneously to cancel the move command. To move a card from
the Deck to the Waste Pile, press the right mouse button.
If a card is face down, just place the mouse cursor over it and press the
left mouse button to turn the card face up.
The following commands are available during play, and can be issued by
placing the mouse cursor over the corresponding 'command button' (on the
lower right hand corner of the screen) and pressing the left mouse but-
ton:
UNDO: undoes the last successful move executed. UNDO cannot be used
after a FINISH or another UNDO command.
FINISH: automatically moves all cards that can legally be moved from
the Tableau and the Waste Pile to the Foundation. Caution: you cannot
undo a FINISH command!
HELP: displays a help file. Use the cursor keys (Up, Down, PgUp, PgDn,
Home, and End) to move around the file, and press [Esc] when you are
done viewing it.
RULES: allows you to select which variation you want to play. Choose
the variation by placing the mouse cursor over the number you want and
pressing the left mouse button. Press the right mouse button when
done. The currently selected variation is highlighted. You can then
choose either the strict or relaxed movement rule. Place the mouse
cursor over the desired rule and press the left mouse button, and
press the right mouse button when done.
BACK: allows you to choose from five different card backs. Choose the
design you want by placing the mouse cursor over it and pressing the
left mouse button. Press the right mouse button when done. The cur-
rently selected card number is highlighted in light blue.
3
Klondike User's Manual
-------------------------------------------------------------------------
CONFIG: brings up the Configuration menu. This allows you to customize
your copy of Klondike. The first option, Mouse, can be set to 'Yes'
(always use the mouse; this option is ignored if a mouse driver is not
found when you start Klondike), 'No' (always use the keyboard, even if
a mouse driver is present), or 'Ask' (if a mouse driver is found, asks
at the beginning of each game whether or not you want to use the
mouse). The second option, Sound, can be set to 'Full' (songs and
beeps are enabled), 'Partial' (songs disabled, but error beeps
enabled), or 'Off' (both songs and beeps disabled). Finally, the third
option, Error Messages, can be set to 'Yes' (displays a context-
sensitive error message each time an error occurs), or 'No' (does not
display the error messages, errors are indicated by beeps if Sound is
either Full or Partial). To select an option, place the mouse cursor
over it and press the left mouse button. Currently selected options
are highlighted. Press the right mouse button when done. If you want
to configure Klondike to use a variation or card back other than the
defaults, select the desired options BEFORE you issue the Config com-
mand. When Config saves your configuration, it will save the currently
selected variation and card back. If you are playing from a
floppy-disk, do NOT write-protect the disk, otherwise Config will not
be able to write the configuration information.
INFO: displays Copyright and Version information, and your registra-
tion number if you have a registered copy. Press any mouse button to
return to the game after you are done viewing the information.
NEW: interrupts the current game and starts a new one. You are asked
to confirm by selecting either 'Yes' or 'No' from a dialog box. Use
the left mouse button to enter your selection.
QUIT: quits Klondike. You are asked to confirm by selecting either
'Yes' or 'No' from a dialog box. Use the left mouse button to enter
your selection.
If you are using Variation 1 or Variation 2, press the right mouse button
after the Pack is exhausted (as if you were moving one more card from the
Pack to the Waste) and the Waste will be moved back to the Pack.
4
Klondike User's Manual
-------------------------------------------------------------------------
GAME PLAY - KEYBOARD
====================
To Move a card, first press the key corresponding to the Origin, then
press the key corresponding to the Destination. For example, to move from
the Pack to pile 1, press P then 1. Valid Origins are 1 to 7, P, and W.
Valid Destinations are 1 to 7, W, and F. If you select a card to be moved
and decide not to move that card, press the Esc key to cancel the move
command.
If a card is face down, press the key corresponding to that card and it
will be turned face up. You can turn only the first card of the Pack and
cards on the Tableau (1 to 7) that are face down.
Note that the NumLock option is automatically turned on when you play
using the keyboard. You can then use the numeric keypad to play. The
keypad keys work as indicated below:
+------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
| | | | | | | | | | | | | | |- |
| | | | | | | | | | | | | | |Quit |
+------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
+------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
|7 | |8 | |9 | |PrtSc | |7 | |8 | |9 | |+ |
|Pile 7| |Pack | |Waste | |New | |Pile 7| |Pack | |Waste | | |
+------+ +------+ +------+ +------+ +------+ +------+ +------+ | |
+------+ +------+ +------+ +------+ +------+ +------+ +------+ | |
|4 | |5 | |6 | |- | |4 | |5 | |6 | | |
|Pile 4| |Pile 5| |Pile 6| |Quit | |Pile 4| |Pile 5| |Pile 6| |Finish|
+------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
+------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
|1 | |2 | |3 | |+ | |1 | |2 | |3 | |Enter |
|Pile 1| |Pile 2| |Pile 3| | | |Pile 1| |Pile 2| |Pile 3| | |
+------+ +------+ +------+ | | +------+ +------+ +------+ | |
+---------------+ +------+ | | +---------------+ +------+ | |
|0 | |. | | | |0 | |. | | |
|Foundation | |Undo | |Finish| |Foundation | |Undo | |New |
+---------------+ +------+ +------+ +---------------+ +------+ +------+
Standard AT keyboard Enhanced keyboard
The following commands are available during play, and can be issued by
typing the highlighted letter from the corresponding 'command button' (on
the lower right hand corner of the screen):
UNDO: undoes the last successful move executed. UNDO cannot be used
after a FINISH or another UNDO command.
FINISH: automatically moves all cards that can legally be moved from
the Tableau and the Waste Pile to the Foundation. Caution: you cannot
undo a FINISH command!
5
Klondike User's Manual
-------------------------------------------------------------------------
HELP: displays a help file. Use the cursor keys (Up, Down, PgUp, PgDn,
Home, and End) to move around the file, and press [Esc] when you are
done viewing it.
RULES: allows you to select which variation you want to play. Choose
the variation by typing the corresponding number. Press [Enter] when
done. The currently selected variation is highlighted. You can then
choose either the strict or relaxed movement rule. Press either S for
strict or R for relaxed, and press [Enter] when done.
BACK: allows you to choose from five different card backs. Choose the
design you want by pressing the corresponding number, and press
[Enter] when done. The currently selected card number is displayed in
light blue.
CONFIG: brings up the Configuration menu. This allows you to customize
your copy of Klondike. The first option, Mouse, can be set to 'Yes'
(always use the mouse; this option is ignored if a mouse driver is not
found when you start Klondike), 'No' (always use the keyboard, even if
a mouse driver is present), or 'Ask' (if a mouse driver is found, asks
at the beginning of each game whether or not you want to use the
mouse). The second option, Sound, can be set to 'Full' (songs and
beeps are enabled), 'Partial' (songs disabled, but error beeps
enabled), or 'Off' (both songs and beeps disabled). Finally, the third
option, Error Messages, can be set to 'Yes' (displays a context-
sensitive error message each time an error occurs), or 'No' (does not
display the error messages, errors are indicated by beeps if Sound is
either Full or Partial). You will be prompted to enter the desired
option for Mouse, Sound and Error Messages, in that order. Press
either Y, N or A for Mouse; F, P or O for Sound; and Y or N for Error
Messages. Press [Enter] after selecting each one. Currently selected
options are highlighted. If you want to configure Klondike to use a
variation, scoring method, or card back other than the defaults,
select the desired options BEFORE you issue the Config command. When
Config saves your configuration, it will save the currently selected
variation, scoring method, and card back. If you are playing from a
floppy-disk, do NOT write-protect the disk, otherwise Config will not
be able to write the configuration information.
INFO: displays Copyright and Version information, and your registra-
tion number if you have a registered copy. Press any key to return to
the game after you are done viewing the information.
NEW: interrupts the current game and starts a new one. You are asked
to confirm by selecting either 'Yes' or 'No' from a dialog box. Press
either Y or N to enter your selection.
6
Klondike User's Manual
-------------------------------------------------------------------------
QUIT: quits Klondike. You are asked to confirm by selecting either
'Yes' or 'No' from a dialog box. Press either Y or N to enter your
selection.
If you are using Variation 1 or Variation 2, press P after the Pack is
exhausted (as if you were moving one more card from the Pack to the
Waste) and the Waste will be moved back to the Pack.
COMMAND-LINE OPTIONS
====================
The following options can be specified when you load Klondike:
-mouse selects the mouse as the input device. This option is
ignored if a mouse driver is not found.
-nomouse selects the keyboard as the input device.
-ask asks whether or not you want to use the mouse. This option
is ignored if a mouse driver is not found. [Default]
-fullsound turns full sound (songs and error beeps) on. [Default]
-partsound turns partial sound (error beeps, but no songs) on.
-nosound turns both songs and error beeps off.
-var[n] selects Variation [n], where [n] is a number from 0 to 2.
[Default is -var0]
-strict selects the Strict movement rule. [Default]
-relaxed selects the Relaxed movement rule.
-back[n] selects card back [n], where [n] is a number from 1 to 5.
[Default is -back1]
-errormsgon turns error messages on. [Default]
-errormsgoff turns error messages off.
Note that the command-line switches have precedence over the settings
selected through the Config command. So, if you have Klondike currently
configured to use card back 2 and the relaxed movement rule, but you load
it as
klondike -back5 -strict
card back 5 and the strict movement rule will be used.
7
Klondike User's Manual
-------------------------------------------------------------------------
REGISTRATION
============
You are granted a license to try this program for a period of 21 days. If
you continue to use it after the trial period is over, you must register
by sending the registration form and $15 (registration only) or $20 (reg-
istration, latest version on disk, and printed manual) to
Eduardo Martins
Station A P.O. Box 2052
Champaign, IL 61825-2052
When you register Klondike, you receive a registration number and
instructions on how to store it into your copy. This number will then be
displayed instead of the 'Unregistered Evaluation Copy' message on the
opening screen and on the Info window, and the Shareware screen that is
displayed after you quit the game will be supressed.
Note that, except for the differences listed above, the evaluation and
the registered copies are identical. The evaluation copy is fully func-
tional.
UPGRADES
========
All registered users are entitled to free upgrades to the latest version
of Klondike. It can be downloaded from CompuServe's IBMNEW Forum (Library
6), GEnie's IBMPC RoundTable (Software Library 7) or from Bulletin Board
Systems all over the country. The following BBS will always have the
latest version, uploaded directly by me:
Argus Computerized Exchange 617-229-2345
The Third Millenium 208-664-2983
Xanadu 217-384-2127
AJAX 201-256-7499
PC Help Desk 205-882-6167
You can also get it directly from me, by sending a $5 check to cover
diskette and mailing costs. If you get it from me, I will also send a
neat, PostScript quality printed manual.
8
Klondike User's Manual
-------------------------------------------------------------------------
TECHNICAL SUPPORT
=================
If you have any questions or comments about Klondike, please write to
Eduardo Martins
Station A, P.O. Box 2052
Champaign, IL 61825-2052
or leave electronic mail to 73300,267 on CompuServe or E.MARTINS on
GEnie.
While I have made every effort to ensure that this software works pro-
perly, I know better than to claim that you will never experience prob-
lems while using it. If you believe you have found a bug, please report
it in as much detail as possible, including a reproducible sequence of
events that leads to the problem, a complete description of your hardware
(including mouse manufacturer and mouse driver version number), DOS ver-
sion used, amount of free memory reported by CHKDSK, and a copy of your
CONFIG.SYS and AUTOEXEC.BAT files.
NOTES FOR USERS OF PREVIOUS VERSIONS
====================================
Version 2.1 and below
* When using the mouse, you no longer have to press the right button to
finish moving a card. Simply press the left button again and the move
will be made. Press the right button to move a card from the Pack to
the Waste Pile. You can still place the cursor over the Pack, click
the left button, then place the cursor over the Waste Pile, and click
the left button again, but it is obviously a lot easier just to click
the right button (the cursor doesn't even have to be over the Pack).
* The RE-USE command is gone. After the Pack is exhausted, simply press
the right mouse button (as if you were moving one more card from the
Pack to the Waste) and the Waste will be moved back to the Pack (as-
suming, of course, that you are using either variation 1 or 2). If
you're playing from the keyboard, press P (for Pack) instead.
* A new Registration procedure has been added. After you register, you
will receive a registration number and instructions on how to 'burn
it' into your Klondike copy. This number will then be displayed when
you issue the INFO command, and the Shareware screen that is displayed
on unregistered copies will be suppressed. Note that these are the
ONLY differences between registered and unregistered copies; the eval-
uation copy is fully functional, and is not crippled in ANY way.
9
Klondike User's Manual
-------------------------------------------------------------------------
Version 2.2
* The top card of the Pack is now ALWAYS face down. When you 'click' on
the Pack, the cards are automatically moved to the Waste pile, either
one or three at a time, depending on which rule set you are using. The
top card of the Waste pile is always available for play. This conforms
more closely to the 'official' Klondike rules.
* An UNDO command has been added. You can now undo your LAST move. Undo
can only be used after a SUCCESSFUL move command, i.e., after you have
successfully moved a card from one location to another. It CANNOT be
used after you turn a card face up, or use the FINISH command.
* A NEW (for New Game) command has been included. To quit the current
game and start a new one, simply click the NEW button. You'll be asked
to confirm your choice, and, if you reply 'yes', a new game will be
started. The QUIT command now does NOT ask whether you want to play
again, since you can start a new game directly from NEW. This saves
keystrokes both when quitting the game and when starting a new one.
* The FINISH command now moves cards from the Waste pile to the
Foundations.
* The Help system was completely rewritten. Now, instead of viewing a
single Help screen, you can browse through a much longer and more
detailed Help file. Error handling was greatly enhanced, and you now
get an Error Message telling WHY a particular move cannot be made
(this can be optionally turned off either through the CONFIG command
or through the -nomessage command line option).
ACKNOWLEDGEMENTS
================
Klondike was written using Borland's Turbo Pascal 5.0, Turbo Power Soft-
ware's Turbo Professional 5.0, and Genus Microcomputing's PCX Program-
mer's Toolkit and PCX Effects.
I wish to thank everybody at CompuServe's Borland (BPROGA) Forum. Their
help and support has been invaluable. I also wish to thank the following
individuals:
* Neil Rubenking, author of PianoMan, used to add the title and congrat-
ulation screen songs;
* Michael Day, author of the Mouse unit, used to add mouse support;
* Tim Godfrey, author of the GrafText unit, used for the extremely fast
graphics-mode screen writes;
10
Klondike User's Manual
-------------------------------------------------------------------------
* and, last but not least, all the users and friends who beta-tested
Klondike and made significant contributions, especially Mael Martins,
John Middleton, David L. Blair, Angel Cruz, Karl Zero, and Bill Mul-
lin.
ABOUT SHAREWARE
===============
(Definition supplied by the Association of Shareware Professionals)
Shareware distribution gives users a chance to try software before buying
it. If you try a Shareware program and continue using it, you are
expected to register. Individual programs differ on details -- some
request registration while others require it, some specify a maximum
trial period. With registration, you get anything from the simple right
to continue using the software to an updated program with a printed man-
ual.
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as
stated below. Shareware authors are accomplished programmers, just like
commercial authors, and the programs are of comparable quality. (In both
cases, there are good programs and bad ones!) The main difference is in
the method of distribution. The author specifically grants the right to
copy and distribute the software, either to all and sundry or to a spe-
cific group. For example, some authors require written permission before
a commercial disk vendor may copy their Shareware.
So, Shareware is a distribution method, not a type of software. You
should find software that suits your needs and pocketbook, whether it's
commercial or Shareware. The Shareware system makes fitting your needs
easier, because you can try before you buy. And because the overhead is
low, prices are low also. Shareware has the ultimate money-back guarantee
-- if you don't use the product, you don't pay for it.
This program is produced by a member of the Association of Shareware
Professionals (ASP). ASP wants to make sure that the shareware principle
works for you. If you are unable to resolve a shareware-related problem
with an ASP member by contacting the member directly, ASP may be able to
help. The ASP Ombudsman can help you resolve a dispute or problem with an
ASP member, but does not provide technical support for members' products.
Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or
send a Compuserve message via easyplex to ASP Ombudsman 70007,3536.
11
Klondike User's Manual
-------------------------------------------------------------------------
REGISTRATION FORM KLONDK23
=================
To register Klondike, please send this form and a $15 check to
Eduardo Martins
Station A P.O. Box 2052
Champaign, IL 61825-2052
NAME: _________________________________________________
ADDRESS: ______________________________________________
______________________________________________
______________________________________________
Where did you get your copy of Klondike?
_
|_| CompuServe CIS User ID: ___________________
_
|_| GEnie GEnie address: _________________
_
|_| BBS (please give name and number): _____________________________
_
|_| Public (software) Library
_
|_| Other (please specify): ________________________________________
Comments/Suggestions
____________________________________________________________________
____________________________________________________________________
____________________________________________________________________
____________________________________________________________________
____________________________________________________________________
____________________________________________________________________
Thank you for registering Klondike!
12