                        PATIENCE ver. 2.13

     English documentation by Charles B. Dorsett, Jr. for COAST

* * * * * * * * * * * * * * * MENU SELECTIONS * * * * * * * * * * * * * * *

1.0  PATIENCE.

     1.1-1.6:  Eiffel T., Matriarchy, Standard, Klondike, Gallery, Braid.  
Selecting any of these options interrupts the current game.  The cards are 
reshuffled and dealt again for the game selected.  To restart any game, 
select its name again.  You will be asked to confirm whether you really want 
to restart.

     1.7  Demo <D>.  Whatever game has been selected will now operate 
automatically in demo mode.  The demo will continue indefinitely until you 
press a key or the left mouse button.  The demo will cycle through all the 
games available.  THIS DEMO IS NOT PARTICULARLY INTELLIGENT, AS IT SHOULD 
NOT BE.  But it is quite suitable for learning the rules of play, and for 
displaying in your shop window.  The 'D' key performs the same function.

     1.8  "1.0 s delay".  In demo mode, the computer will delay the number 
of seconds indicated after each play before displaying the hint arrow.  You 
can change the delay time by clicking on this choice, and when the dialog 
box appears, selecting any time between 0 and 9.9 seconds.  The default time 
is 1.0 seconds, and the value you have selected will appear in the drop-down 
menu.

     1.9  Save <S>.  The current game will be saved in its exact state, to 
be loaded and played later.  The file will be given a .PAT extension.  The 
'S' key performs the same function.

     1.10  Load <L>.  A file previously saved with SAVE can be loaded for 
immediate play.  The game will resume at the exact place you left off.  The 
'L' key performs the same function.

     1.11   End <E>.  The game will end and the program will terminate.  You 
will be asked to confirm.  The 'E' key performs the same function.

     1.12  <N>.  (NEW GAME)  The cards will be redealt for a new round of 
the same game.  There is no mouse equivalent for this function.

2.   INFORMATION.

     2.1  Rules of Play.  Displays this file.

     2.2  Copies.  If you want to make copies of this program, read the 
dialog box.

3.   HELP.

     3.1  Hint <V> <HELP>.  All possible plays will be shown to you with an 
arrow, one play each time you invoke the function.  If no play is possible, 
the computer will chime.  The 'V' and <HELP> keys perform the same function.

     3.2  Build up <A>.  If it is possible to build cards on any of the 
available Foundations, this selection will do all of them.  You can achieve 
the same result with the right mouse button or the 'A' key.

     3.3  Undo <Z> <UNDO>.  This selection will undo the last play, no 
matter what it was.  You can undo as many as 220 plays.  The <UNDO> key or 
the 'Z' key performs the same function.

     3.4  Restart.  The current game will be completely reset to the 
beginning, as it was originally dealt.

     3.5  Mark <M>.  The current game state will be marked so that you can 
return to this point quickly.  Only one mark can be maintained at a time, so 
if you make a new mark, it automatically erases the old one.  The 'M' key 
also performs this function.

     3.6  Go to Mark.  The current game will be returned to the last mark.

     3.7  "no rules".  The ordinary rules of play are suspended while this 
function remains active and the checkmark is displayed beside this menu 
selection.  Thus you can cheat your way out of any bind.  However, if you 
follow the rules anyway, nobody will accuse you of cheating.

4.   >  CARDS  <

     4.1  Hit me <K>.  The next card(s) will be played from the Talon.

* * * * * * * * * * * * * * * * GAME RULES * * * * * * * * * * * * * * * *

     1.   Generally.

     There are some characteristics common to all the games in this package.  
They are all played with standard 52-card decks, either one or two.  The 
cards in each suit are ranked King high.  K stands for 'King', D stands for 
Queen (German 'Dame') and B stands for Jack (German 'Bube').  In each game, 
the cards are piled up in either ascending or descending order, on stacks 
in the main playing area, called the Tableau, or piles off to the side, 
called Foundations.  Some piles must be built up in sequence within the same 
suit, and others are built up in suits of alternating colors.

     The Talon is the stack of cards remaining in the deck, not yet played 
upon any of the piles, and not yet placed in the discard pile.  Some people 
also call it the Stock.

     The object of each of these games is to use up all the cards in 
building Foundations, or to use up all cards in the Talon according to the 
rules of the particular game.  If all the cards are used up, you win.  If 
not, you lose.

     In all of the games, you deal cards from the Talon to the discard pile 
by clicking once on the Talon with the left mouse button, or pressing <K>.  
Where permitted by the rules, you can turn over any face-down card with a 
single click of the left mouse button.  You pick up and move a card by 
clicking on it and holding the button down while you drag it to its intended 
destination.  If the move would violate the rules, the card will not go 
anywhere, and the computer will chime.  If any card or cards can be put on a 
Foundation, or in the Ace discard pile of Picture Gallery, a single press of 
the <A> key will do all of them, a handy way to quickly finish certain 
games.  Sometimes the <A> key will build up the Foundations more than you 
would like, and these rules allow you to put cards back into the Tableau 
from the Foundations.

     2.   STANDARD.

     This is the standard version of Patience.  The object is to build up 
all eight of the Foundations at the right from Ace up through King, all in 
the same suit.  The eight playing piles in the Tableau all start with two 
cards face-down and one showing.  The cards can then be stacked according to 
the following rules:

     -    Red cards may be only played on black cards, and black only on 
          red.

     -    Only the next smaller card may be played, so that the stacks are 
          in descending sequence.

     -    When you are able to uncover a face-down card, click on it to turn 
          it over.  The cards do not turn over automatically.

     -    An empty space can be filled with any card.

     -    You can move whole sequences of cards, but only as long as they 
          are all in proper order.

     When no more moves are possible, click on the Talon.  One card will be 
added to each of the playing piles.  If you get to the end of the Talon 
before building up all the Foundations, you lose.

     3.   EIFFEL TOWER.

     This is a simple game, which takes its name from the shape of the 
layout.  The object is to use up all the cards from the Talon, placing them 
on the Tower.  You can only put a card on top of another card when the 
numerical values of the two cards adds up to 14.  King is worth 13, Queen is 
worth 12 and Jack is worth 11.  You do not have to follow suit.  You win 
when the Talon is all gone.

     4.   THE MATRIARCHY.

     The object of this game is to build sequences until all the cards are 
used up.  Cards are placed on Queens in descending order, following suit.  
Kings are placed on the empty spaces above the queens, and then cards are 
placed on the Kings in ascending order, starting with Ace, also following 
suit.  For each rank you complete, (that is, having one card of each value) 
you get an extra chance at going through the Talon.  You are permitted to 
move cards from one pile to another, as long as you still follow the rules.  
The first time you go through the Talon, the cards are given two at a time.  
The second time, it is three cards, and so on up to twelve.  If by that time 
you have completed any ranks, your bonus runs start at eleven, then ten, and 
so on.  You win if you complete all the ranks.

     5.   KLONDIKE.

     The German name for this game is "little harp".  It is played with a 
single deck.  The rules are the same as for "Standard", except that when you 
click on the Talon, one card is turned over onto the discard pile, and you 
are only permitted to fill empty spaces with Kings.  There is no limit to 
the number of times you go through the Talon.  You are also permitted to 
move cards back out of the Foundation, and to shift them around on the piles 
in the Tableau.

     6.   THE PICTURE GALLERY.

     The layout consists of three rows of playing piles, a row for newly-
dealt cards, and a castoff pile for Aces.

     All Aces are cast off to the pile on the right.  Use the <A> key; the 
computer won't do it automatically.  When you clear a space on the Tableau, 
you can only fill it with the right card.  In the first row, you build up 
sequences starting with a Four, in the second row with a Three, and in the 
third row with a Two.  You build up sequences incrementing by three, up to 
the face cards.  Thus, in the first row, each pile is 4-7-10-K, in the 
second row 3-6-9-D, and in the third row, 2-5-8-B.  Once a sequence has been 
started, you have to follow suit.  When no further moves are possible, click 
on the Talon for a fresh row of cards at the bottom.  If the Talon is gone 
and you clear a space at the bottom, you can fill it with any card.  You win 
when the entire Gallery is filled with pictures, that is, face cards.

     7.   THE BRAID.

     This game is somewhat harder and requires thoughtful strategy.  The 
object is to build up the Foundations to the right so that all cards are 
used up.

     The layout consist of a Braid of 20 cards, two groups of four helper 
fields, four braid fields (each showing a picture of a braid), the discard 
pile, and the eight Foundations.  The first card automatically dealt to a 
Foundation sets the beginning value for all Foundations, and an indicator 
displays the value of that card.

     You choose whether the sequences on the Foundations will be ascending 
or descending, and your choice is displayed in an indicator.  The choice is 
made when you place the first card on a Foundation which is not the already-
determined base card.  It must follow suit and must have a numerical value 
of either one more or one less than the base card.  Ace is considered one 
higher than King, and at the same time one less than Two.

     You may place cards on the Foundation from anywhere on the table, 
including the end of the Braid.  The eight helper fields can be filled from 
the discard pile but not from the Braid or the braid fields.  When you move 
a card from a braid field to the Foundation, that field is automatically 
filled with the last card on the Braid itself.

     You can use the helper fields to temporarily store cards you expect to 
use soon, and you can leave them open until the right card comes up from the 
Talon.  In going through the Talon, you are limited to three rounds, and an 
indicator reports on that status.

* * * * * * * * * * * * * * *  MISCELLANEOUS  * * * * * * * * * * * * * * * 

     If you like this program, send a donation to the author:

     Volker Weidner
     Kapellenstr. 56a
     D-76131 Karlsruhe
     GERMANY

     This address will be correct until the end of 1990.  
Thereafter, send to:

     Volker Weidner
     Pilgrim-von-Buchein-Str. 18
     D-6967 Buchen
     WEST GERMANY

     Or if you know how, you can pipe the money straight to the author's 
bank account:

     Account No.:                          18 11 63 13 82
     Citibank (Zentrale Dsseldorf) BLZ :  300 209 00

     With all correspondence or donations, always give your full current 
mailing address so you can remain informed about new Patience versions.

     So that all donors receive the same service, the author has established 
the following procedures.  They're too involved to translate, so here they 
are in the original:

          "1.   Geleistete Spende:  Smtliche Spenden, die ich von 
     einer Person/Personengruppe bekomme, werden zu einem 
     Gesamtspendenbetrag aufaddiert und die Daten ber Name, 
     Adresse und Spendenbetrag gespeichert.  Soll keine 
     Speicherung erfolgen, oder die gespeicherten Daten gelscht 
     bzw. gendert werden (Umzug!), gengt eine entsprechende 
     Mitteilung.  Eine Auskunft ber die gespeicherten Daten 
     erhalten Sie gegen einen Unkostenbeitrag von DM 5.
          "2.   Standart-Spende:   Bei jeder Programmvariante wird 
     der erwartete (erhoffte) Spendenbetrag in den beiliegenden 
     Spielregeln erwhnt. Fr Patience sind das:
     Patience Version 1.1 : DM 20
     Patience Version 2.1x : DM 25
          "3.   Mitteilung:  bersteigt die geleistetet Spende die 
     erwartete um DM 5, so erfolgt an den Spender eine 
     schriftliche Mitteilung, sobald eine neue Programmversion 
     vorliegt.  Der gespeicherte Spendenbetrag wird bei mir um DM 
     5 vermindert.
          "4.   Versendung: bersteigt die Spende sogar eine 
     Differenz von DM 15, so wird eine neue Version dem Spender 
     automatisch auf einer doppelseitigen Diskette zugeschickt.  
     Der gespeicherte Spendenbetrag wird bei mir um DM 10 
     vermindert.  (DM 5 Vertrauensbonus!)
          "5.   bersteigt der jeweils verbleibende Restbetrag die 
     in 3. bzw 4. erwhnten Grenzen, erfolgt erneut eine 
     Mitteilung bzw. Versendung, sofern eine neuere Version 
     vorliegt.
               "Beispiel 1:  Sie besitzen Version 1.1 
          (Standartspende: DM 20) und spenden DM 25 oder mehr. 
          Sobald eine neue PD-Version fertiggestellt und ausgiebig 
          getestet wurde, wird an den/die Spender eine Mitteilung 
          ber die neue Version gesendet (Neuer Kontostand DM 20).  
          Erfolgt daraufhin eine Zusatzspende von DM 10, so sende 
          ich diese neue Version auf Diskette zu. (Kontostand 
          weiterhin DM 20, da die Kosten fr eine Versendung DM 10 
          betragen).  Um erneut eine Mitteilung ber die nchste 
          Version zu bekommen, gengt eine Aufstockung der Spende 
          um DM 10 (d.h Kontostand DM 30, Standartspende DM 25 => 
          Differenz DM 5).
               "Beispiel 2:  Sie besitzen Version 1.1 
          (Standartspende: DM 20) und spenden DM 35 oder mehr. 
          Sobald eine neue PD-Version fertiggestellt und ausgiebig 
          getestet wurde, wird an den/die Spender diese neue 
          Version zugesendet.  (Neuer Kontostand DM 25)  Um erneut 
          eine Mitteilung ber die nchste Version zu bekommen, 
          gengt eine Aufstockung der Spende um DM 5 (d.h 
          Kontostand DM 30, Standartspende DM 25 => Differenz DM 
          5).
          "Die oben erklrte Vorgehensweise bedeutet fr die 
     aktuelle Version 2.12:  Falls der gespendete Betrag DM 30 
     bersteigt und mir die vollstndige Adresse bekannt ist, 
     werden Sie ber den nchsten Update automatisch von mir 
     informiert. Bei einem Betrag >= DM 40 wird Ihnen die nchste 
     Version automatisch auf einer Diskette zugeschickt.
          "Falls mir Ihre vollstndige Adresse nicht bekannt sein 
     sollte, oder eine Speicherung der Daten abgelehnt wird, sind 
     diese Serviceleistungen leider nicht mglich."
 
     Basically, all this means that if you send money, you get info on 
updates.  If you send more (40 Deutschmarks) the next version will be sent 
automatically.  If you remember to include your name and address, you get on 
the mailing list.  COAST suggests sending $15 by international money order.  
If you feel like translating the author's detailed procedures into English, 
please write to Charles B. Dorsett, Jr., 88 Kearny Street, Suite 1310, San 
Francisco, CA 94108 (USA).

     The author says: "For whoever this is too complicated, let it be said 
that comparable programs available for sale on the one hand must be more 
expensive, and on the other hand cannot provide such a generous update 
service (if at all!).  So, whoever sends money to me (and it's the right 
amount!) provides the incentive for me to write another PD, or to further 
improve this program."
     "So much for the technical details ...
     "...  and now Anja and Volker wish you lots of fun with PATIENCE."

     He did a good job with these games, didn't he?  So send him the money!

* * * * * * * * * * * * * * * * * * End * * * * * * * * * * * * * * * * * *

