<?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.6"><!--Applicaion 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 id="kpat" lang="&language;"> <!-- do not change this! -->
<bookinfo>
	<title>The &kappname; Handbook</title> <!-- This is the title of the docbook. Leave 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>2012-08-06</date><!-- Date of (re)writing, or update.-->
<releaseinfo>&kappversion; (&kde; 4.9)</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 suit in as few moves as 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 fit 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 the rest is easy; keep arranging and rearranging the cards and 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. Each of the games has 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 talon (also called the stock). You can find this quite easily, since in most games it is the only pile in which all cards are face down.</para>
			</listitem>
		</varlistentry>
		<varlistentry><term>2. Waste Pile</term>
			<listitem><para><indexterm><primary>waste pile</primary></indexterm>Many games use a waste pile to hold cards taken from the talon. Typically clicking on the talon will cause the topmost card to be flipped face up and placed on the waste pile, at which point the card enters play.</para>
			</listitem>
		</varlistentry>
		<varlistentry><term>3. Foundation</term>
			<listitem><para><indexterm><primary>foundation</primary></indexterm>The foundation piles are where you want your cards to end up. Typically, the game is one only once all cards have been moved to the foundation piles in the correct order. The number of foundation piles and the ordering required varies from game to game.</para>
			<para>Most games start with the foundation piles empty. Choosing the <guimenuitem>Drop</guimenuitem> action from the menu or toolbar will cause &kpatience; to scan through all the piles move as many cards to the foundation piles as it can. If you have the <guimenuitem>Enabled Autodrop</guimenuitem> setting activated, &kpatience; will attempt to perform a drop whenever possible.</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>

<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>

<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 there are no more possible moves, you can redeal the cards. A redeal
consists of picking up the cards from the playing piles (pile by pile, left to
right) and redealing them in the starting pattern (zigzagging rows of face down
cards forming a peak and then left to right rows of face up cards on top). Note
that the cards are <emphasis>not</emphasis> shuffled and that cards on the foundation piles
are left untouched. You may redeal no more than twice in a single game.
</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>

<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>

<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>

<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-J, in the second
row the sequence 3-6-9-Q, 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>

<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>

<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>

<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>

<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>

<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 nine is at 12 o'clock, the queen is at 3 o'clock, the three is at 6 o'clock
and the six is at 9 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>

</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>

<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 descending 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 Game Menu</title>
		<variablelist>
			<varlistentry id="game-menu-new-game">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>New Game...</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Return to the game selection screen.</action> This action abandons the deal in progress.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-new-deal">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>New Deal</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Start a new deal of the same game type.</action> This action abandons the deal in progress.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-new-numbered-deal">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>New Numbered Deal...</guimenuitem>
				</menuchoice></term>
				<listitem>
					<para><action>Start a new deal by specifying the game type and deal number.</action> This action abandons the deal in progress.</para>
					<para>&kpatience; gives each deal a unique indentifying number (which it uses internally to randomize the deck during the initial deal). This feature allows you to replay a deal of interest or to attempt a particularly difficult deal recommended by a friend. Especially dedicated players may wish to "beat" &kpatience; by playing all 2147483647 deals consecutively for each of the game types.</para>
					<para>Note that for Freecell, &kpatience;'s deal numbers match those described in <ulink url="http://www.solitairelaboratory.com/fcfaq.html">the Freecell FAQ</ulink>.</para>
				</listitem>
			</varlistentry>
			<varlistentry id="game-menu-restart-deal">
				<term><menuchoice>
					<shortcut><keycap>F5</keycap></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Restart Deal</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Return the current game to its initially dealt condition.</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>Load a saved game.</action> This action abandons the deal in progress.</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 recently accessed save files in order of last use.</action> Selecting a game will load it. This action abandons the deal in progress.</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 As...</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Save the current game to disk.</action></para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-statistics">
				<term><menuchoice>
					<guimenu>Game</guimenu>
					<guimenuitem>Statistics</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Display various statistics about your performance broken down by game type.</action></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 Move 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>
			<varlistentry id="move-menu-redo">
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Redo</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Redo</action> the move that was just undone by <guimenuitem>Undo</guimenuitem>.</para></listitem>
			</varlistentry>
			<varlistentry id="move-menu-hint">
				<term><menuchoice>
					<shortcut><keycap>H</keycap></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Hint</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Provide some hints as to possible moves, should the player become stuck. Cards that can be legally moved to another pile are temporarily highlighted.</action></para></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-demo">
				<term><menuchoice>
					<shortcut><keycap>D</keycap></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Demo</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Start the demo mode.</action> While in demo mode, &kpatience; attempts to solve the deal for you. Activate this action a second time to exit demo mode.</para></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-draw">
				<term><menuchoice>
					<shortcut><keycap>Space</keycap></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Draw</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Flip one of more cards from the talon and move them to the waste pile.</action> This action is available in only certain games.</para></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-deal-row">
				<term><menuchoice>
					<shortcut><keycap>Return</keycap></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Deal Row</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Flip several cards from the talon and place one on each playing pile.</action> This action is available in only certain games.</para></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-redeal">
				<term><menuchoice>
					<shortcut><keycap>R</keycap></shortcut>
					<guimenu>Move</guimenu>
					<guimenuitem>Redeal</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Collect all the card left in play and redeal them without shuffling.</action> This action is available in only certain games.</para></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="settings-menu">
	<title>The Settings Menu</title>
		<variablelist>
			<varlistentry id="settings-menu-game-type-options">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guisubmenu>"Game Type" Options</guisubmenu>
					<guimenuitem>List of game type specific options.</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>List options specific to the current game type.</action> This menu is available in only certain games (Klondike and Spider).</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-deck">
				<term><menuchoice>
					<shortcut><keycap>F10</keycap></shortcut>
					<guimenu>Settings</guimenu>
					<guimenuitem>Change Appearance...</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Open a dialog to change the card deck and game theme used.</action></para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-autodrop">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Enable Autodrop</guimenuitem>
				</menuchoice></term>
				<listitem><para>Enable automatically moving cards to the foundation piles when possible.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-solver">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Enable Solver</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Enable the automatic solving engine.</action> When enabled, the solver will constantly try to determine whether the current game state is winnable. You may wish to disable the solver to conserve processor or battery usage.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-remember">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Remember State on Exit</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Enable automatic saving of the game state when &kpatience; is shut down.</action> If enabled, &kpatience; will load the previous game state automatically the next time it is started.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-toolbar">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Show Toolbar</guimenuitem>
				</menuchoice></term>
				<listitem><para>Show or hide the toolbar.</para></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-statusbar">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Show Statusbar</guimenuitem>
				</menuchoice></term>
				<listitem><para>Show or hide the statusbar.</para></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="help"><!--This is a standard Help menubar entry. Only change if needed.-->
<title>The Help 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>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 and the game theme. To do so please use <menuchoice>
					<shortcut><keycap>F10</keycap></shortcut>
					<guimenu>Settings</guimenu>
					<guimenuitem>Change Appearance...</guimenuitem>
				</menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Can I use the keyboard to play the game?</para></question>
 <answer><para>No, &kappname; features no keyboard only play. However, most menu options do have keyboard shortcuts.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Even with hints I still have no clue how to play. Help!</para></question>
 <answer><para>Besides the <quote>Hint</quote> feature there also is a useful <quote>Demo</quote> 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 the <link linkend="howto">How to Play</link> and <link linkend="rules_and_tips">Game Rules, Strategies and Tips</link> sections of this handbook.</para></answer>
</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; &kappversion; by &Richard.Hawthorne;
&Richard.Hawthorne.mail;
</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:
-->
