<?xml version="1.0" ?>
<!--IMPORTANT: please note that'do not change this!' notice does not apply to translators -->
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpatience;">
  <!ENTITY kappversion "3.0"><!--Applicaion version. Use this variable everywhere it's needed.-->
  <!ENTITY docversion "2.2.2"><!--Document version. Use this variable everywhere it's needed.-->
  <!ENTITY docupdate "2007-11-06"><!--Document version. Use this variable everywhere it's needed.-->
  <!ENTITY package "kdegames">  <!-- do not change this! -->
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
  <!ENTITY % addindex "IGNORE"> <!-- do not change this! -->
]>

<book lang="&language;"> <!-- do not change this! -->
<bookinfo>
	<title>The ""&kappname;"" Handbook</title> <!-- This is the title of the docbook. Live as is unless change is necessary.-->
<!-- List of immidiate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
<author>
<firstname>Paul Olav</firstname>
<surname>Tvete</surname>
</author>
<author>
<firstname>Maren</firstname>
<surname>Pakura</surname>
</author>
<author>
<firstname>Stephan</firstname>
<surname>Kulow</surname>
</author>

<othercredit role="reviewer">
<firstname>Mike</firstname><surname>McBride</surname>
<contrib>Reviewer</contrib>
<affiliation><address>&Mike.McBride.mail;</address></affiliation>
</othercredit>

<othercredit role="developer">
<firstname>Paul Olav</firstname>
<surname>Tvete</surname>
<contrib>Developer</contrib>
</othercredit>

<othercredit role="developer">
<firstname>Stephan</firstname>
<surname>Kulow</surname>
<contrib>Developer</contrib>
</othercredit>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2000</year>
<holder>&Paul-Olav.Tvete;</holder>
</copyright>

<copyright>
<year>2001</year><year>2004</year>
<holder>&Maren.Pakura;</holder>
</copyright>

<copyright>
<year>2007</year>
<holder>&Stephan.Kulow;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>&docupdate;</date><!-- Date of (re)writing, ro update. Use the variable definitions within header to change this value.-->
<releaseinfo>&docversion;</releaseinfo><!-- Application version number. Use the variable definitions within header to change this value.-->

<!--Short description of this document. Do not change unless necessary!-->
<abstract>
	<para>This documentation describes the game of "&kappname;" version &kappversion;</para>
</abstract>

<!--List of relevan keywords-->
<keywordset>
	<keyword>KDE</keyword> <!-- do not change this! -->
	<keyword>kdegames</keyword> <!-- do not change this! -->
	<keyword>game</keyword> <!-- do not change this! -->
	<keyword>KPatience</keyword><!--Application name goes here-->
<!-- Game genre. use as many as necessary.Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword>card</keyword>
	<keyword>card game</keyword>
	<keyword>playing cards</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword>one player</keyword>
<!--All other relevant keywords-->
	<keyword>patience</keyword>
	<keyword>solitaire</keyword>
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"><title>Introduction</title> <!-- do not change this! -->
	<note><title>Gametype:</title><para>Card</para></note><!-- Game genre. use as many as necessary.Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note><title>Number of possible players:</title><para>One</para></note><!--Number of possible players. It can be: One, Two,..., Multiplayer-->

<!--Short game description starts here. 3-4 sentences (paragraphs)-->

<para>
To play patience you need, as the name suggests, patience.  For simple games,
where the way the game goes depends only upon how the cards fall, your patience might be
the only thing you need.
</para>

<para>
There are also patience games where you must plan your strategy and think
ahead in order to win.
</para>

<para>
A theme common to all the games is the player must put the cards in a special order &mdash; 
moving, turning and reordering them.
</para>
</chapter>

<chapter id="howto"><title>How to Play</title> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note><title>Objective:</title><para>Rearrange the cards by suite within shortest time possible.</para></note><!--Describe the objective of the game.-->
<!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
	<para>
	As "&kappname;" offers you a multiplicity of different solitaire games, there is no straightforward how-to which could feet all of them. Therefore, it is essential that you read each individual subsection of Game Rules, Strategies and Tips section before you start playing a version you are not familiar with.</para>
<para>
Essentially there are two types of solitaire games – the ones that let you arrange the cards by same color and the ones that let you arrange the cards by alternating color. You can easily determine which game you are trying out using trial-and-error method. Once you know which one you are dealing with, rest is easy; keep arranging and rearranging the cards, collecting the matching ones.</para>
<para>
From the beginning, however, pay attention to your card stacks. Do not rush to move individual cards around, see if it might be more useful elsewhere.</para>
<para>
For additional help you can also take quick peeks onto the statusbar. For the
most of the games there is a built in solver which informs you whether the game
you are currently playing can be completed or not. If you see that solver could
not complete the current game, chances are you will not be able to do so as
well. At this point you can either restart the current game, or start a
completely new game.
</para>
<note><title>Note:</title><para>Playing solitaire games helps you to greatly improve your attention span and enhance the ability to concentrate.</para></note>
</chapter>

<chapter id="rules_and_tips"><title>Game Rules, Strategies and Tips</title> <!-- do not change this! -->

<sect1 id="rules-general">
	<title>General Rules</title>
	<para><indexterm><primary>suits</primary></indexterm>A card game contains one or more card decks of 52 cards each. Each deck contains the four suits:</para>
	<informaltable pgwide="0" frame="none">
		<tgroup cols="2"><colspec/><colspec/>
	<tbody>
		<row valign="middle">
			<entry><inlinemediaobject><imageobject><imagedata fileref="clubs.png"/></imageobject></inlinemediaobject></entry>
			<entry>Clubs</entry>
		</row>
		<row valign="middle">
			<entry><inlinemediaobject><imageobject><imagedata fileref="spades.png"/></imageobject></inlinemediaobject></entry>
			<entry>Spades</entry>
		</row>
		<row valign="middle">
			<entry><inlinemediaobject><imageobject><imagedata fileref="hearts.png"/></imageobject></inlinemediaobject></entry>
			<entry>Hearts</entry>
		</row>
			<row valign="middle"><entry><inlinemediaobject><imageobject><imagedata fileref="diamonds.png"/></imageobject></inlinemediaobject></entry>
			<entry>Diamonds</entry>
		</row>
	</tbody></tgroup>
	</informaltable>
	<para>Each of these suits contains the following card types: ace, two, three, four, five, six, seven, eight, nine, ten, jack, queen, and king.</para>
	<para><indexterm><primary>family</primary></indexterm> This complete order of cards is called a family. There are real families and alternating ones. The real families are all of one suit (&eg; Hearts). In the alternating families the card color changes from one to another, between a black color (Clubs and Spades) and a red color (Hearts and Diamonds).</para>
	<para>If the family is not complete it is called a sequence.</para>
	<mediaobject>
		<imageobject><imagedata fileref="playfield.png" format="PNG"/></imageobject>
		<textobject><phrase>The game field of &kpatience;</phrase></textobject>
	</mediaobject>
	<para>There are a number of features found in typical patience games. These are described below.</para>
	<variablelist>
		<varlistentry><term>1. Talon</term>
			<listitem><para><indexterm><primary>talon</primary></indexterm>At the beginning of each game all cards are mixed in the deck. In some games not all cards are dealt out. The remaining cards are put down on the so-called talon. You can find this quite easily, since in most games it is the only pile showing the reverse. </para>
			<para>If no card shows the reverse side, all cards are dealt out and there is no talon. These card games are the hardest as there is no randomness involved after the start of the game, so there is nothing to blame. </para>
			</listitem>
		</varlistentry>
		<varlistentry><term>2. Waste Pile</term>
			<listitem><para><indexterm><primary>waste pile</primary></indexterm>Many games put cards from the talon on a waste pile, after you click on the reverse of the topmost card on the talon.</para>
			<para>From there you can take the card (which is then face up) and put it into the game.</para>
			</listitem>
		</varlistentry>
		<varlistentry><term>3. Foundation</term>
			<listitem><para><indexterm><primary>foundation</primary></indexterm>The foundation pile is where you want to have your cards in the end.  If allcards end up there in the right order, you've won. Some games use more than one foundation pile.</para>
			<para>In most card games these piles are empty in the beginning. &kpatience; drops cards there for you when it sees they fit. </para>
			</listitem>
		</varlistentry>
		<varlistentry><term>4. Playing Piles</term>
			<listitem><para><indexterm><primary>playing piles</primary></indexterm>These piles are those where the actual reordering happens. The rules for these piles vary a lot between games. Some show all cards on them, some do not. Some allow only one card to be removed, some allow every card to be removed, &etc;. </para>
			</listitem>
		</varlistentry>
	</variablelist>
</sect1>

<sect1 id="rules-specific"><title>Rules for Individual Games</title>

<sect2 id="klondike">
<title>Klondike</title>
<anchor id="game_klondike" />

<para><indexterm><primary>Klondike</primary></indexterm>
Klondike is the most famous patience &mdash; most likely because it comes with a well-known operating system. 
It is played with one deck.
</para>

<para>
The goal in Klondike is to put all cards, as real families, ascending on the
foundation. This gets easier once all cards are lying face
up in the playing piles.
</para>

<para>
The sequences on the playing piles have to be put there in descending order. The cards
should alternate in colors (red and black). You can move whole sequences or
parts of it, if the first card fits on another pile.
</para>

<para>
On a free pile you can put a king of any color, or a sequence starting with a
king.
</para>

<para>
When you click on the talon, one card from it will be moved to the waste pile.
You can move it to the playing piles or the foundation from there.
If the talon is empty, you can move the complete waste pile to the talon
by clicking on the empty talon.
</para>

<para>
You can look through the cards on the talon as much as you like.
</para>
</sect2>

<sect2 id="grandfather">
<title>Grandfather</title>
<anchor id="game_grandfather"/>

<para><indexterm><primary>Grandfather</primary></indexterm>
This game was introduced to &Paul-Olav.Tvete;, the original developer of &kpatience;, by his grandfather; it is named after this. 
No other patience games are known to implement this patience game variant.
</para>
        
<para>
In Grandfather, one deck is dealt to seven playing piles. Some cards on each pile
are face down on the initial deal.
</para>

<para>
The goal is to put all cards as real families ascending on the foundation piles.
</para>

<para>
You can move every card on every pile if it fits on another card, to build a real
sequence of descending order. For example, you can move the five of spades on
top of the six of spades, no matter how many cards on are on top of the five of
spades. Just the six of spades has to be on top of its pile.
</para>

<para>
On a free pile you can place a king (again no matter how many cards are on top of
it).
</para>

<para>
If no more cards can be moved, you can re-deal up to two times. All cards already
in the foundations stay there, but the cards in the playing piles are reordered
to give you a new chance to find a solution.
</para>

<para>
Even though the rules are simple and allow many moves, the game is still
hard to win. Despite this, or because of it, this game remains a joy to play.
</para>
</sect2>

<sect2 id="aces-up">
<title>Aces Up</title>
<anchor id="game_aces_up"/>

<para><indexterm><primary>Aces Up</primary></indexterm>
This patience has simple rules, yet is hard to win.  It is played
with one deck. The goal is to put all cards besides aces onto the
foundation. There should be an ace left on every playing pile afterwards.
</para>

<para>
Each top card that is of the same suit (&eg; spades) and has a lower
value than another top card (&eg; six of spades and four of spades) can be
put on the foundation by clicking on it.
</para>

<para>
If you cannot move any more cards to the foundation, you can get a new card for
each playing pile by clicking on the talon.
</para>

<para>
On a free pile you can move every other card on top of a pile. You should use these
moves to free piles. That way, new cards can be moved to the foundation.
</para>

<para>
The auto drop feature is disabled in this patience game.
</para>

</sect2>

<sect2 id="freecell">
<title>Freecell</title>
<anchor id="game_freecell"/>

<para><indexterm><primary>Freecell</primary></indexterm>
Freecell is played with one card deck. You have four free cells in the top left
corner. In addition there are four foundation piles, and eight playing piles below.
</para>

<para>
The goal of the game is to have all cards as real families ascending on the
foundation. You can achieve this often if you know how to play: 
Freecell is solvable at a rate of 99.9% approximately &mdash; of the first 32,000 deals there is only
one unsolvable (11,982 if you want to know).
</para>

<para>
In the playing piles you have to build descending sequences, where red and black
cards alternate. You can put any card in a free cell.
</para>

<para>
You can only move one card that lays on top of a pile or a free cell.
Sequences can only be moved if you have enough free space (either free cells or free
playing piles) to place the cards.
</para>

<para>
The maximum amount of cards you can move is calculated by:
</para>

<sidebar><para>
(#{free cells} + 1) * 2<superscript>#{free piles}</superscript>
</para></sidebar>

<para>
To solve this game it is recommended to grab the cards out of the playing
sequences in the same order they have to be put into the foundation (first the
aces, then the twos, &etc;)
</para>

<para>
You should try to keep as many free cells and/or playing piles empty, so you can
build sequences as long as possible.
</para>

</sect2>

<sect2 id="mod3">
<title>Mod3</title>
<anchor id="game_mod3"/>

<para><indexterm><primary>Mod3</primary></indexterm>
Mod3 is played with two card decks. The goal is to put all
cards on the top three rows. In those you have to build sequences of the same
color. In the first row you have to create the sequence 2-5-8-B, in the second
row the sequence 3-6-9-D, and in the third row the sequence 4-7-10-K. The suit of
the cards must be the same in each sequence, so you can only put a five of hearts
on top of a two of hearts.
</para>

<para>
The fourth row is both your waste pile and playing pile. On an empty slot you can
put any card from the first three rows, or one from the top of the fourth row.
</para>

<para>
You can put aces on the aces piles, on top of the talon. They are in the game
so you have a starting point for creating free slots.
</para>

<para>
If you cannot move any more cards, you can get new cards on the fourth row by
clicking on the talon.
</para>

<para>
The auto drop feature is disabled in this patience game.
</para>
</sect2>

<sect2 id="gypsy">
<title>Gypsy</title>
<anchor id="game_gypsy"/>
<para><indexterm><primary>Gypsy</primary></indexterm>
Gypsy is played with two card decks. The aim is to put all cards in
real families ascending on the foundation.
</para>

<para>
The playing piles have to be descending, while red and black cards have to
alternate. You can only move sequences or single cards. On a free slot you can
put any card or sequence.
</para>

<para>
If you cannot move any more cards, you can click on the talon to get new cards on each playing pile.
</para>

<para>
In using the <guibutton>Undo</guibutton> feature you can ease the game quite a lot, as you have to take
many decisions and some of them might turn out to be wrong after you
clicked the talon.
</para>

</sect2>

<sect2 id="forty-and-eight">
<title>Forty &amp; Eight</title>
<anchor id="game_forty_and_eight"/>

<para><indexterm><primary>Forty &amp; Eight</primary></indexterm>
Forty &amp; Eight is played with two card decks. The goal is to put all
cards as real families on the foundation.
</para>

<para>
The playing piles have to be descending. 
Colors are important. You can only put a five of hearts on a six of hearts, for example.
</para>

<para>
You can only move one card on top of a pile. You can put any card in a free slot.
</para>

<para>
By clicking on the talon you can put a card on the waste pile; from there you
can put it on a playing pile or the foundation (&kpatience; will do this for you).
If the talon is empty you can put all cards on the waste pile back on the talon.
This works only once: after the second time the talon empties, the game is over.
</para>

<para>
This patience is difficult to solve. With some experience you can
solve many of the deals, especially if you use the <guibutton>Undo</guibutton> feature from time to time to
correct your decisions, and the decisions &kpatience; makes in putting cards on the
foundation.
</para>
</sect2>

<sect2 id="simple-simon">
<title>Simple Simon</title>
<anchor id="game_simple_simon"/>

<para><indexterm><primary>Simple Simon</primary></indexterm>
Simple Simon is played with one card deck. The goal is to put all cards
as real families on the foundation.
</para>

<para>
In the playing piles you can build sequences. In general you don't have to care
about the suits of the cards, but sequences can only be moved if they are part
of a real sequence. For example, you can move the six of spades if the five 
of <emphasis>spades</emphasis> is on top of it, 
but may not move it if the five of <emphasis>clubs</emphasis> is on top of it.
</para>

<para>
The cards can only be moved to the foundation if all 13 cards of one family lay
on top of each other in the playing piles.
</para>

<tip>
<title>Suggestion</title>
<para>
You should try as soon as possible to move the cards to the correct piles, to
create free piles to place cards on temporarily, since you can put any card on those.
</para>

<para>
With enough free room you can build families on free slots independently of the
color. If you have all cards in such families you can sort them by color, so they can be moved to the foundation.
</para>
</tip>

</sect2>

<sect2 id="yukon">
<title>Yukon</title>
<anchor id="game_yukon"/>

<para><indexterm><primary>Yukon</primary></indexterm>
Yukon is played with one card deck. The goal is to put all cards as real
families ascending on the foundation.
</para>

<para>
The sequences on the playing piles have to be descending with alternating red and
black cards. You can move every face up card no matter how many cards are on top
of it. So you can put a five of hearts on a six of spades if that one is on top of its pile.
</para>

<para>
In a free slot you can put a king of any color (again, no matter how many cards are on top
of it)
</para>
</sect2>

<sect2 id="grandfathers-clock">
<title>Grandfather's Clock</title>

<anchor id="game_grandfathers_clock"/>
<para><indexterm><primary>Grandfathers Clock</primary></indexterm>
Grandfather's clock is a simple patience game. With some experience you should
be able to solve most deals. It is played with one card deck. The aim is to put the cards 
as real ascending sequences on the foundation.
</para>

<para>
The foundation is on the right-hand side and consists of 12 piles that form the shape
of a clock. The ace is at one o'clock, the jack is at 11 o'clock, and the queen is at 12
o'clock.
</para>

<para>
There are 8 playing piles beside the clock and on each are 5 cards. On the
playing piles you can build descending sequences. The color of the cards is not important. 
You can only move one card at a time.
</para>

<para>The auto drop feature is disabled in this patience game.</para>

</sect2>

<sect2 id="golf">
<title>Golf</title>

<para><indexterm><primary>Golf</primary></indexterm> 
Golf is played with one card deck.  The goal of Golf is to move all the cards on the tableau to the foundation. </para>
 
<para>The layout of golf solitaire is straightforward. At the beginning of the game you will see the tableau. 
On it are seven columns each containing five cards. The talon and the foundation are below. 
</para>

<para>Playing golf solitaire is simple, but requires strategy to win.  
The cards at the base of each column on the tableau are available for play. 
Available cards are built upon the top foundation card in ascending or descending sequence regardless of suit. 
If there are no moves available a card may be dealt from the talon to the foundation. 
The game is over when all the cards in the talon have been dealt and there are no more possible moves.</para>

</sect2>

<sect2 id="spider">
<title>Spider</title>

<anchor id="game_spider"/>
<para><indexterm><primary>Spider</primary></indexterm>
Spider is played with two card decks. The cards are dealt out into 10 playing
piles, 4 of 6 cards and 6 of 5 cards each. This leaves 50 cards that can be
dealt out 10 at a time, one on each playing pile.
</para>

<para>
In the playing piles, a card can be placed on another card of any suit and
of one higher value.  A sequence of ascending cards of the same suit may be
moved from one playing pile to another.
</para>

<para>
The goal of spider is to put all cards as real families descending from
Kings anywhere in the playing piles.  When such a family is built in a
playing pile, it is removed to the lower-left corner of the window.
</para>

<para>
The different levels determine how many suits are dealt - Easy uses 1 suit,
Medium uses 2 suits, and Hard uses all 4 suits.  The game is fairly easy to
win at Easy level, and very difficult to win at Hard level.
</para>

</sect2>

</sect1>

</chapter>

<chapter id="interface"><title>Interface Overview</title> <!-- do not change this! -->
<!-- This section has to do with menubar. Describe every single entry in order. Use <variablelist> and <varlistentry>. Split the chapter into sections using <sect1(2,3)> for better viewing.-->
<sect1 id="game-menu">
	<title>The <guimenu>Game</guimenu> Menu</title>
		<variablelist>
			<varlistentry id="game-menu-new">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>New</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Starts a new game.</action></para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-load">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Load...</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Loads a saved game.</action></para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-load-recent">
				<term><menuchoice>
					<guimenu>Game</guimenu>
					<guisubmenu>Load Recent</guisubmenu>
					<guimenuitem>List of recently accessed files.</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>List</action> all recently accessed save files.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-restart">
				<term><menuchoice>
					<shortcut><keycap>F5</keycap></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Restart Game</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Restart</action> the current game.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-save">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Save</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Save</action> the current game as a default save file.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-chose-game">
				<term><menuchoice>
					<guimenu>Game</guimenu>
					<guimenuitem>Choose Game...</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Opens</action> the game selection dialog.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-statistics">
				<term><menuchoice>
					<guimenu>Game</guimenu>
					<guimenuitem>Statistics</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Opens</action> the game win/loose statistics dialog.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-hint">
				<term><menuchoice>
					<shortcut><keycap>H</keycap></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Hint</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Show a hint.</action></para></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-demo">
				<term><menuchoice>
					<shortcut><keycap>D</keycap></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Demo</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Switch on/off</action> the demo mode.</para></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-quit">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Quit</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Quit</action> "&kappname;".</para></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="move-menu">
	<title>The <guimenu>Move</guimenu> Menu</title>
		<variablelist>
			<varlistentry id="move-menu-undo">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Undo</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Undo</action> your last move.</para></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="settings-menu">
	<title>The <guimenu>Settings</guimenu> Menu</title>
		<variablelist>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Klondike</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Klondike game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Grandfather</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Grandfather game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Aces Up</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Aces Up game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Freecell</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Freecell game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Napoleon's Tomb</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Napoleon's Tomb game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Mod3</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Mod3 game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Calculation</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Calculation game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Gypsy</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Gypsy game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Forty and Eight</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Forty and Eight game mode.</para> </listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Simple Simon</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Simple Simon game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Yukon</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Yukon game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Grandfather's Clock</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Grandfather's Clock game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Golf</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Golf game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Klondike (draw 3)</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Klondike (draw 3) game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Spider (Easy)</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Spider (Easy) game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Spider (Medium)</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Spider (Medium) game mode.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>Game Type</guisubmenu>
					<guimenuitem>Spider (Hard)</guimenuitem>
				</menuchoice></term>
				<listitem><para>Switch to Spider (Hard) game mode.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-autodrop">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Disable Autodrop</guimenuitem>
				</menuchoice></term>
				<listitem><para>Enable/Disable automatically moving matching cards.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-random">
				<term><menuchoice>
					<shortcut><keycap>F9</keycap></shortcut>
					<guimenu>Settings</guimenu>
					<guimenuitem>Random Cards</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Randomly pick</action> card faces and backs.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-deck">
				<term><menuchoice>
					<shortcut><keycap>F10</keycap></shortcut>
					<guimenu>Settings</guimenu>
					<guimenuitem>Select Deck...</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Open</action> the carddeck selection dialog.</para></listitem>
			</varlistentry>			
			<varlistentry id="settings-menu-toolbar">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Show Toolbar</guimenuitem>
				</menuchoice></term>
				<listitem><para>Shows or hides the Toolbar.</para></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="help"><!--This is a standard Help menubar entry. Only change if needed.-->
<title>The <guimenu>Help</guimenu> Menu</title>
&help.menu.documentation;
</sect1>
</chapter>

<chapter id="faq"><title>Frequently asked questions</title> <!-- do not change this! -->
<!--This chapter is for frequently asked questions. Please use <qandaset> <qandaentry> only!-->
<qandaset>
<!--Following is a standard list of FAQ questions.-->
<qandaentry>
<question><para>Who made this game?</para></question>
 <answer><para>The kdegames team. You can find their website <ulink url="http://games.kde.org">here</ulink>.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Where can I get cheatcodes? </para></question>
 <answer><para>You cannot get cheatcodes for &kde; games.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>How do I start a new game? </para></question>
 <answer><para>To start a new game use <menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>New</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>How do I restart a my current game? </para></question>
 <answer><para>To restart a current game use <menuchoice>
					<shortcut><keycap>F5</keycap></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Restart Game</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>How do I pause the game? </para></question>
 <answer><para>"&kappname;" features no 'Pause' function at the moment.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I want to change the way this game looks. Can I? </para></question>
 <answer><para>You can change the faces and backs of the playing cards. To do so please use <menuchoice>
					<shortcut><keycap>F10</keycap></shortcut>
					<guimenu>Settings</guimenu>
					<guimenuitem>Select Deck...</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I have made a mistake. Can I undo? </para></question>
 <answer><para>Yes. To undo a wrong move you can use <menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Undo</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Can I use keyboard?</para></question>
 <answer><para>No. "&kappname;" features no possible keyboard play.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I cannot figure out what to do here! Are there hints? </para></question>
 <answer><para>Yes. To take advantage of the 'Hint' feature use <menuchoice>
					<shortcut><keycap>H</keycap></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Hint</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Even with hints I still have no clue how to play. Help!</para></question>
 <answer><para>Besides the 'Hint' feature there also is a useful 'Demo' mode, where the built in artificial intelligence will play the game for you. You can try to watch and learn. However, if you have any questions it is better to read <link linkend="howto">How to Play</link> and <link linkend="rules_and_tips">Game Rules, and Strategies and Tips</link> sections of this handbook.</para></answer><!--IMPORTANT!: this link has to send user to 'Interface Overview' section. So please setup the link structure accordingly.-->
</qandaentry>
<qandaentry>
 <question><para>I have to quit the game now, but I am not finished yet. Can I save my progress?</para></question>
  <answer><para>Yes. To save your progress you can use <menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Save</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Where are the high scores?</para></question>
 <answer><para>"&kappname;" has no high score board. However you can view your win vs loose statistics. To do so use <menuchoice>
					<guimenu>Game</guimenu>
					<guimenuitem>Statistics</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I want to change the game configuration. Where do I go? </para></question>
 <answer><para>"&kappname;" requires no configuration.</para></answer><!--IMPORTANT!: this link has to send user to 'Interface Overview' section. So please setup the link structure accordingly.-->
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits"><title>Credits and License</title> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->

<para>
"&kappname;"  <!-- do not change this! -->
</para>
<!--List all the copyright holders here-->
<para>
&kpatience; Copyright &copy; 1995-2000 &Paul-Olav.Tvete;
</para>

<para>
&kpatience; Copyright &copy; 2001-2007 &Stephan.Kulow;
&Stephan.Kulow.mail;
</para>

<para>
Freecell Solver by Shlomi Fish
<email>shlomif@vipe.technion.ac.il</email>
</para>

<para>
Documentation Copyright &copy; 2000 &Paul-Olav.Tvete;
</para>

<para>
Documentation updated for &kde; 2.0 by &Mike.McBride;
&Mike.McBride.mail;
</para>

<para>
Documentation rewritten for &kpatience; 2.0 (&kde; 2.1) by &Maren.Pakura;
&Maren.Pakura.mail;
</para>

<para>
Documentation proofread and update for &kpatience; &docversion; by Richard Hawthorne
<email>techno_plume-coding@yahoo.com</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;

<!-- !!!do not change ANYTHING after this line!!!! -->

</chapter>

<appendix id="installation">
<title>Installation</title>

&install.intro.documentation;


<sect1 id="Compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>
</appendix>

&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
