Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegames@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

13 files changed, 1016 insertions, 0 deletions

diff --git a/doc/kmahjongg/Makefile.am b/doc/kmahjongg/Makefile.am
new file mode 100644
index 00000000..085981d9
--- /dev/null
+++ b/doc/kmahjongg/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kmahjongg/background.png b/doc/kmahjongg/background.png
new file mode 100644
index 00000000..f4ba2700
--- /dev/null
+++ b/doc/kmahjongg/background.png
diff --git a/doc/kmahjongg/boardeditor.png b/doc/kmahjongg/boardeditor.png
new file mode 100644
index 00000000..bd146782
--- /dev/null
+++ b/doc/kmahjongg/boardeditor.png
diff --git a/doc/kmahjongg/config.png b/doc/kmahjongg/config.png
new file mode 100644
index 00000000..d6923171
--- /dev/null
+++ b/doc/kmahjongg/config.png
diff --git a/doc/kmahjongg/gamescreen.png b/doc/kmahjongg/gamescreen.png
new file mode 100644
index 00000000..22d6c603
--- /dev/null
+++ b/doc/kmahjongg/gamescreen.png
diff --git a/doc/kmahjongg/highscore.png b/doc/kmahjongg/highscore.png
new file mode 100644
index 00000000..4d5667d2
--- /dev/null
+++ b/doc/kmahjongg/highscore.png
diff --git a/doc/kmahjongg/index.docbook b/doc/kmahjongg/index.docbook
new file mode 100644
index 00000000..37173b49
--- /dev/null
+++ b/doc/kmahjongg/index.docbook
@@ -0,0 +1,1012 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!-- Define an entity for your application if it is not part of KDE
+       CVS -->
+  <!ENTITY kappname "&kmahjongg;">
+  <!ENTITY package "kdegames">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE">
+	
+	<!ENTITY John.Hayes '<personname><firstname>John</firstname><surname>Hayes</surname></personname>'>
+	<!ENTITY John.Hayes.mail '<email>justlinux@bellsouth.net</email>'>
+
+  <!ENTITY Mathias.Mueller '<personname><firstname>Mathias</firstname><surname>Mueller</surname></personname>'>
+	<!ENTITY Mathias.Mueller.mail '<email>in5y158@public.uni-hamburg.de</email>'>
+  <!ENTITY Albert.Astals.Cid '<personname><firstname>Albert</firstname><othername>Astals</othername><surname>Cid</surname></personname>'>
+	<!ENTITY Albert.Astals.Cid.mail '<email>astals11@terra.es</email>'>
+  <!ENTITY David.Black '<personname><firstname>David</firstname><surname>Black</surname></personname>'>
+	<!ENTITY David.Black.mail '<email>david.black@lutris.com</email>'>
+  <!ENTITY Michael.Haertjens '<personname><firstname>Michael</firstname><surname>Haertjens</surname></personname>'>
+	<!ENTITY Michael.Haertjens.mail '<email>mhaertjens@modusoperandi.com</email>'>
+  <!ENTITY Osvaldo.Stark '<personname><firstname>Osvaldo</firstname><surname>Stark</surname></personname>'>
+	<!ENTITY Osvaldo.Stark.mail '<email>starko@dnet.it</email>'>
+  <!ENTITY Benjamin.Meyer '<personname><firstname>Benjamin</firstname><surname>Meyer</surname></personname>'>
+	<!ENTITY Benjamin.Meyer.mail '<email>ben+kmahjongg@meyerhome.net</email>'>
+
+]>
+
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kmahjongg; Handbook</title>
+
+<authorgroup>
+<author>
+&John.Hayes;
+&John.Hayes.mail;
+</author>
+
+<othercredit role="developer">
+&Mathias.Mueller; &Mathias.Mueller.mail;
+</othercredit>
+
+<othercredit role="developer">
+&Albert.Astals.Cid; &Albert.Astals.Cid.mail;
+</othercredit>
+
+<othercredit role="developer">
+&David.Black; &David.Black.mail;
+</othercredit>
+
+<othercredit role="developer">
+&Michael.Haertjens; &Michael.Haertjens.mail;
+</othercredit>
+
+<othercredit role="developer">
+&Osvaldo.Stark; &Osvaldo.Stark.mail;
+</othercredit>
+
+<othercredit role="developer">
+&Benjamin.Meyer; &Benjamin.Meyer.mail;
+</othercredit>
+
+</authorgroup>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+<copyright>
+<year>2005</year>
+<holder>John Hayes</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2006-01-23</date>
+<releaseinfo>0.7.6</releaseinfo>
+
+
+<abstract>
+<para>
+&kmahjongg; is a game similar to famous oriental game <trademark>Mahjongg</trademark>.
+</para>
+</abstract>
+
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdegames</keyword>
+<keyword>KMahjongg</keyword>
+<keyword>Mahjongg</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>
+&kmahjongg; is a game similar to the famous oriental game <trademark>Mahjongg</trademark>. The purpose of the game
+is to remove all of the tiles from the gameboard. Tiles are removed by matching tiles in
+pairs. The matched tiles must have a free side on the left or on the right. Please report
+any problems or feature requests to the &kde; mailing lists.
+</para>
+</chapter>
+
+<chapter id="gameplay">
+<title>Gameplay</title>
+
+<!-- This chapter should tell the user how to use your app. You should use as
+many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
+your application. -->
+
+<sect1 id="start-new-game">
+<title>Starting a New Game</title>
+
+<para>When &kmahjongg; is started, the board is setup and the game timer is started, waiting
+for your first move. A new game can be started from selecting
+<menuchoice>
+<guimenu>Game</guimenu><guimenuitem>New</guimenuitem>
+
+</menuchoice> or pressing 
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+.
+</para>
+
+<para>
+There is also the option of starting a specific number games. All of the games are numbered and they are randomly selected from 
+<menuchoice>
+<guimenu>Game</guimenu><guimenuitem>New</guimenuitem>
+
+</menuchoice>.
+
+A specific number game can be started by selecting
+<menuchoice>
+<guimenu>Game</guimenu><guimenuitem>New Numbered Game</guimenuitem>
+</menuchoice>
+</para>
+
+</sect1>
+
+<sect1 id="aim-of-game">
+<title>Aim of the Game</title>
+
+<para>The purpose of the game is to remove all of the tiles from the gameboard. Tiles are
+removed by matching tiles in pairs, which then disappear. The matched tiles must have a
+free side on the left or on the right.
+</para>
+
+</sect1>
+
+<sect1 id="playing-the-game">
+<title>Playing the Game</title>
+
+<para>
+Locate and select with the mouse, matching tiles that have a free side on the left or right side.
+The tiles disappear as they are selected and matched.
+</para>
+
+<para>
+There are two options to help find matching tiles that have a free side.
+One option is to get a hint by selecting
+<menuchoice>
+<guimenu>Move</guimenu><guimenuitem>Hint</guimenuitem>
+
+</menuchoice> or pressing <keycap>H</keycap>
+which will flash a pair of matching tiles.
+The second option is to activate
+<menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Show Matching Tiles</guimenuitem>
+</menuchoice>,
+which will highlight the selected tile and flash any matching tiles that have a free side
+with each move. No additional tiles will be highlighted if there are no matching tiles with a free side.
+</para>
+
+</sect1>
+
+<sect1 id="game-screen">
+<title>The Game Screen</title>
+
+<para>
+
+<screenshot>
+<screeninfo>A screenshot of &kmahjongg;</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="gamescreen.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+A quick explanation of the parts of the game screen...
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term>Game Screen</term>
+<listitem>
+<para>
+The Game screen is in the center of the screen and is the largest section of the window.
+The background is populated with the game tiles.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Game Timer</term>
+<listitem>
+<para>
+The Game Timer is located on the top right of the screen. The timer keeps track of the
+elapsed time from the start of the game until the game is finished.
+</para>
+</listitem>
+
+</varlistentry>
+
+<varlistentry>
+<term>Statusbar</term>
+<listitem>
+<para>
+The Statusbar is located at the bottom of the screen, and contains three panes. The first
+pane lists the removed/total tiles and the number of matching tiles that have free sides. 
+The second pane gives the sequence number of the game you are playing. In the last pane
+lets the player know when the game is ready.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+</chapter>
+
+<chapter id="game-configuration">
+<title>Configuration and Default Keybindings</title>
+
+<para>The configuration options are as follows:</para>
+
+
+<sect1 id="configure">
+<title>Configure &kmahjongg;</title>
+
+<!--
+<variablelist>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure KMahjong...</guimenuitem></menuchoice></term>
+<listitem>
+<para>Opens the Configure dialog.
+-->
+<screenshot>
+<screeninfo>Configure Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="config.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Configure Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+<!--
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+-->
+
+<para><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kmahjongg;...</guimenuitem></menuchoice>
+opens the Configure &kmahjongg; Dialog.</para>
+
+<sect2 id="general-options"><title><guilabel>General</guilabel> options</title>
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Show removed tiles</guilabel></term>
+<listitem>
+<para>
+Places a grid to the right of the gameboard where matching tiles are stacked after being removed from the gameboard.
+<screenshot>
+<screeninfo>Here's a screenshot of &kmahjongg; showing removed tiles.</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="showremoved.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Removed tiles.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Generate solvable games</guilabel></term>
+<listitem>
+<para>
+Selects only games that can be solved when you start a new game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Play winning animation</guilabel></term>
+<listitem>
+<para>
+Shows a replay of all moves when you win a game.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="tiles-options"><title><guilabel>Tiles</guilabel> options</title>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Draw shadows</guilabel></term>
+<listitem>
+<para>
+Draws shadows on the tiles to give a 3D appearance.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Use mini-tiles</guilabel></term>
+<listitem>
+<para>
+Sets the tile size to small.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="background-options"><title><guilabel>Background</guilabel> options</title>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Scaled</guilabel></term>
+<listitem>
+<para>
+Scales the background image.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Tiled</guilabel></term>
+<listitem>
+<para>
+Tiles the background image.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+</sect1>
+
+
+
+<sect1 id="default-keybindings">
+<title>Default Keybindings</title>
+
+<para><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice> allows you to change the default keyboard bindings.</para>
+
+<screenshot>
+<screeninfo>Keybindings Configure Dialog</screeninfo>
+	<mediaobject>
+
+	  <imageobject>
+	    <imagedata fileref="shortcuts.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Keybindings Configure Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<para>
+The default kebindings are as follows:
+</para>
+
+<para>
+<variablelist>
+
+<varlistentry>
+<term><keysym>D</keysym></term>
+<listitem>
+<para>
+Playes the game in Demo mode.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keysym>H</keysym></term>
+<listitem>
+<para>
+Gives you a hint by flashing two matching tiles.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keysym>F1</keysym></term>
+<listitem>
+<para>
+Displays this handbook.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></term>
+<listitem>
+<para>
+Loads a previously saved game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term>
+<listitem>
+<para>
+Starts a new game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keysym>P</keysym></term>
+<listitem>
+<para>
+Pauses or resumes a game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></term>
+<listitem>
+<para>
+Quits the game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></term>
+<listitem>
+<para>
+Move redo.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keysym>F5</keysym></term>
+<listitem>
+<para>
+Restart the game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term>
+<listitem>
+<para>
+Saves the game.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></term>
+<listitem>
+<para>
+Show the highscores.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></term>
+<listitem>
+<para>
+Move undo.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></term>
+<listitem>
+<para>
+What's this? Help
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
+application windows and their menubar and toolbar commands for easy reference.
+Also include any keys that have a special function but have no equivalent in the
+menus or toolbars. This may not be necessary for small apps or apps with no tool
+or menu bars. -->
+
+<sect1 id="kapp-mainwindow">
+<title>The main &kmahjongg; window</title>
+
+<screenshot>
+<screeninfo>A screenshot of &kmahjongg;</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="gamescreen.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<sect2 id="game-menu">
+<title>The <guimenu>Game</guimenu> Menu</title>
+
+<para>
+
+<variablelist>
+
+<varlistentry>
+<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>
+<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>
+<term><menuchoice>
+<shortcut>
+<keysym>F5</keysym>
+</shortcut>
+<guimenu>Game</guimenu>
+<guimenuitem>Restart Game</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Restarts the numbered game being played.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Game</guimenu>
+<guimenuitem>New Numbered Game...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Starts a specific numbered game.</action>
+<screenshot>
+<screeninfo>Start a Numbered Game Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="numbered.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Start a Numbered Game Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Game</guimenu>
+<guimenuitem>Open Theme...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Allows you to load a theme with different backgrounds and tile styles.</action>
+<screenshot>
+<screeninfo>Load Theme Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="theme.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Load Theme Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+The available options:
+<itemizedlist>
+<listitem><para>default (shown)</para></listitem>
+<listitem><para>pirates</para></listitem>
+</itemizedlist>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Game</guimenu>
+<guimenuitem>Open Tileset...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Allows you to load a different tileset.</action>
+<screenshot>
+<screeninfo>Open Tileset Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="tileset.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Open Tileset Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+The available options:
+<itemizedlist>
+<listitem><para>default (shown)</para></listitem>
+<listitem><para>pirates</para></listitem>
+<listitem><para>traditional</para></listitem>
+</itemizedlist>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Game</guimenu>
+<guimenuitem>Open Background...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Allows you to load a different background image.</action>
+<screenshot>
+<screeninfo>Load Background Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="background.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Load Background Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+The available options:
+<itemizedlist>
+<listitem><para>default (shown)</para></listitem>
+<listitem><para>haze</para></listitem>
+<listitem><para>pirates</para></listitem>
+<listitem><para>slate</para></listitem>
+<listitem><para>wood</para></listitem>
+</itemizedlist>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Game</guimenu>
+<guimenuitem>Open Layout...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Allows you to load a different tile layout.</action>
+<screenshot>
+<screeninfo>Load Layout Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="layout.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Load Layout Dialog</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+The available options:
+<itemizedlist>
+<listitem><para>default (shown)</para></listitem>
+<listitem><para>cross</para></listitem>
+<listitem><para>pirates</para></listitem>
+<listitem><para>pyramid</para></listitem>
+<listitem><para>stax</para></listitem>
+<listitem><para>tower</para></listitem>
+<listitem><para>triangle</para></listitem>
+</itemizedlist>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>Game</guimenu>
+<guimenuitem>Save</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Saves</action> the current game.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Game</guimenu>
+<guimenuitem>Save Theme...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Saves the current theme.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keysym>P</keysym>
+</shortcut>
+<guimenu>Game</guimenu>
+<guimenuitem>Pause</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Pauses or resumes the game. While the game is paused, all tiles are hidden.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
+</shortcut>
+<guimenu>Game</guimenu>
+<guimenuitem>Show Highscores</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Shows the highscore list.</action>
+<screenshot>
+<screeninfo>Show Highscores</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="highscore.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Show Highscores</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+When your game scores exceed the top ten scores listed, you are prompted to enter your name.
+</para>
+</listitem>
+</varlistentry>
+
+
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu>Game</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Quits</action> &kmahjongg;.</para></listitem>
+</varlistentry>
+
+</variablelist>
+</para>
+
+</sect2>
+
+<sect2 id="edit-menu">
+<title><guimenu>Edit</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Board Editor</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens the gameboard editor.</action>
+<screenshot>
+<screeninfo>Gameboard Editor</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="boardeditor.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Gameboard Editor</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+The gameboard editor lets you create your own tile layouts for gameplay.
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="move-menu">
+<title><guimenu>Move</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<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>
+<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> a move the was undone.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keysym>H</keysym>
+</shortcut>
+<guimenu>Move</guimenu>
+<guimenuitem>Hint</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Gives a Hint</action> by flashing a matching pair of tiles.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keysym>D</keysym>
+</shortcut>
+<guimenu>Move</guimenu>
+<guimenuitem>Demo</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Starts the game Demo</action> mode.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Move</guimenu>
+<guimenuitem>Shuffle</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Shuffles the tiles</action> on the board.</para></listitem>
+</varlistentry>
+
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="settings-menu">
+<title><guimenu>Settings</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show/Hide Toolbar</guimenuitem></menuchoice></term>
+<listitem>
+<para>Shows or hides the Toolbar.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show/Hide Statusbar</guimenuitem></menuchoice></term>
+<listitem>
+<para>Shows or hides the Statusbar.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show/Hide Matching Tiles</guimenuitem></menuchoice></term>
+<listitem>
+<para>Shows or hides matching tiles by not flashing the matching free tiles when a tile is selected.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice></term>
+<listitem>
+<para><action>Displays a standard &kde; shortcut configuration dialog</action> to change the 
+<link linkend="default-keybindings">keyboard shortcuts</link> for &kmahjongg;.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Toolbars...</guimenuitem></menuchoice></term>
+<listitem>
+<para>Displays a standard &kde; dialog where you can configure the toolbar icons.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kmahjongg;...</guimenuitem></menuchoice></term>
+<listitem>
+<para><action>Opens a dialog to configure &kmahjongg;.</action> For details,
+see <link linkend="game-configuration">here</link>.</para>
+</listitem>
+</varlistentry>
+
+
+</variablelist>
+
+
+</sect2>
+
+<sect2 id="help-menu">
+<title>The <guimenu>Help</guimenu> Menu</title>
+
+<!-- Assuming you have a standard help menu (help, what's this, about -->
+<!-- &kmahjongg;, about KDE) then the documentation is already written. -->
+<!-- The following entity is valid anywhere that a variablelist is -->
+<!-- valid.  -->
+
+&help.menu.documentation;
+
+</sect2>
+
+</sect1>
+</chapter>
+
+
+
+<chapter id="credits">
+
+<!-- Include credits for the programmers, documentation writers, and
+contributors here. The license for your software should then be included below
+the credits with a reference to the appropriate license file included in the KDE
+distribution. -->
+
+<title>Credits and License</title>
+
+<para>
+&kmahjongg; for KDE
+</para>
+
+<para>
+Program Copyright &copy; 1997 &Mathias.Mueller; &Mathias.Mueller.mail;
+</para>
+
+<para>
+Contributors:
+<itemizedlist>
+<listitem><para>&David.Black; &David.Black.mail;</para></listitem>
+<listitem><para>&Michael.Haertjens; &Michael.Haertjens.mail;</para></listitem>
+<listitem><para>&Osvaldo.Stark; &Osvaldo.Stark.mail;</para></listitem>
+<listitem><para>&Benjamin.Meyer; &Benjamin.Meyer.mail;</para></listitem>
+<listitem><para>&Albert.Astals.Cid; &Albert.Astals.Cid.mail;</para></listitem>
+</itemizedlist>
+</para>
+
+<para>
+Documentation Copyright &copy; 2005 &John.Hayes; &John.Hayes.mail;
+</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+
+&underGPL;
+
+</chapter>
+
+</book>
+
diff --git a/doc/kmahjongg/layout.png b/doc/kmahjongg/layout.png
new file mode 100644
index 00000000..38be51e4
--- /dev/null
+++ b/doc/kmahjongg/layout.png
diff --git a/doc/kmahjongg/numbered.png b/doc/kmahjongg/numbered.png
new file mode 100644
index 00000000..142d402e
--- /dev/null
+++ b/doc/kmahjongg/numbered.png
diff --git a/doc/kmahjongg/shortcuts.png b/doc/kmahjongg/shortcuts.png
new file mode 100644
index 00000000..32a941cf
--- /dev/null
+++ b/doc/kmahjongg/shortcuts.png
diff --git a/doc/kmahjongg/showremoved.png b/doc/kmahjongg/showremoved.png
new file mode 100644
index 00000000..33b49957
--- /dev/null
+++ b/doc/kmahjongg/showremoved.png
diff --git a/doc/kmahjongg/theme.png b/doc/kmahjongg/theme.png
new file mode 100644
index 00000000..693373ca
--- /dev/null
+++ b/doc/kmahjongg/theme.png
diff --git a/doc/kmahjongg/tileset.png b/doc/kmahjongg/tileset.png
new file mode 100644
index 00000000..b2ff3854
--- /dev/null
+++ b/doc/kmahjongg/tileset.png