Commit f8fc33ab authored by Burkhard Lück's avatar Burkhard Lück

remove quotes around &kappname, this is wrong inside <gui...></gui...> and not...

remove quotes around &kappname, this is wrong inside <gui...></gui...> and not used in other kde docs
CCMAIL:stephaniewhiting03@hotmail.com
CCMAIL:jeremy@scitools.com

svn path=/trunk/KDE/kdegames/doc/ksudoku/; revision=841523
parent cdcb344a
......@@ -12,7 +12,7 @@
<book lang="&language;"> <!-- do not change this! -->
<bookinfo>
<title>The "&kappname;" Handbook</title> <!-- This is the title of this docbook. -->
<title>The &kappname; Handbook</title> <!-- This is the title of this docbook. -->
<!-- List of immidiate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
......@@ -40,7 +40,7 @@
<!--Short description of this document. Do not change unless necessary!-->
<abstract>
<para>This documentation describes the game of "&kappname;" version &kappversion;</para>
<para>This documentation describes the game of &kappname; version &kappversion;</para>
</abstract>
<!--List of relevan keywords-->
......@@ -62,7 +62,7 @@
<chapter id="introduction"><title>Introduction</title> <!-- do not change this! -->
<note><title>Gametype:</title><para>Logic, Board</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-->
<para>"&kappname;" is a logic-based symbol placement puzzle.</para>
<para>&kappname; is a logic-based symbol placement puzzle.</para>
<para>The player has to fill a grid so that each column, row as well as each square block on the game field contains only one instance of each symbol.</para>
<para>Depending on the preferences and the difficulty level some games start with a partially completed game field, while the others start with a blank one.</para>
<para>There are hundreds of different variations of sudoku in existence. The most common variant of the game has a 9x9 squares grid and uses Arabic numerals for symbols. As an extra constraint, the grid is divided into 9 sectors of 3x3 squares. The problem is – each symbol can only be used once per row, column and sector.
......@@ -83,7 +83,7 @@
<note><title>Note:</title><para>The set of symbols varies depending on the game type you choose.</para></note>
<para>First, note the boundaries of the game field. The thick black lines outline the sectors. Every one of this sectors has to be completed using the symbols available, in such a way that each symbol is used within the sector area once and only once.</para>
<para>Now you can start entering the symbols into the vacant squares on the game field. You can do that by selecting the symbol you wish to enter from the selection list on the left , and then using your mouse to click on the vacant square on the game field.</para>
<para>Notice that the squares change color while you hover your mouse over them. It is done to help you keep up with the rules of "&kappname;". Use the vertical and horizontal lines to check if the symbol, you are about to enter into the vacant spot, is already in use anywhere in the vertical or horizontal line that square is a part of. The coloring also highlights the sector which, if you remember, must also contain only one instance of each symbol.</para>
<para>Notice that the squares change color while you hover your mouse over them. It is done to help you keep up with the rules of &kappname;. Use the vertical and horizontal lines to check if the symbol, you are about to enter into the vacant spot, is already in use anywhere in the vertical or horizontal line that square is a part of. The coloring also highlights the sector which, if you remember, must also contain only one instance of each symbol.</para>
<para>Keep entering the symbols in accordance with the riles until the whole game field is filled up. At this pint the application will check if all the entries are valid and either correct you, or except the solution.
</para>
</chapter>
......@@ -92,9 +92,9 @@
<!--This section has to do with game rules. Please give a detailed description of those using lists or paragraphs.-->
<sect1 id="rules">
<title>General Game Rules</title>
<para>The rules of "&kappname;" are quite simple.</para>
<para>The rules of &kappname; are quite simple.</para>
<itemizedlist>
<listitem><para>Depending on the size of the game board and the difficulty level chosen each individual "&kappname;" puzzle may take up to a few hours to solve.</para></listitem>
<listitem><para>Depending on the size of the game board and the difficulty level chosen each individual &kappname; puzzle may take up to a few hours to solve.</para></listitem>
<listitem><para>Each square may hold one and only one symbol.</para></listitem>
<listitem><para>Each horizontal row (as defined by the game board) can contain each symbol exactly once.</para></listitem>
<listitem><para>Each vertical row (as defined by the game board) can contain each symbol exactly once.</para></listitem>
......@@ -102,21 +102,21 @@
</itemizedlist>
<note><title>Note:</title><para>The set of symbols varies depending on the game type you choose.</para></note>
<itemizedlist>
<listitem><para>Knowledge of mathematics, or language is not required to solve "&kappname;" puzzles.</para></listitem>
<listitem><para>Knowledge of mathematics, or language is not required to solve &kappname; puzzles.</para></listitem>
<listitem><para>Depending on the difficulty chosen the puzzles may appear partially solved. In such case the signs already on the game board cannot be changed.</para></listitem>
<listitem><para>You can only modify the symbols you have previously entered.</para></listitem>
<listitem><para>"&kappname;" generated puzzles have one solution only.</para></listitem>
<listitem><para>&kappname; generated puzzles have one solution only.</para></listitem>
</itemizedlist>
</sect1>
<sect1 id="tips">
<title>Strategies and Tips</title>
<itemizedlist>
<listitem><para>Take your time and do not rush. "&kappname;" is not a 'quick' game to play.</para></listitem>
<listitem><para>Take your time and do not rush. &kappname; is not a 'quick' game to play.</para></listitem>
<listitem><para>Pay attention to the row, column, and section colorings. They are here to aid you in the game.</para></listitem>
<listitem><para>Make sure that so duplicate symbol exists already in the row/column/section you are entering it to.</para></listitem>
<listitem><para>If in doubt, try to foresee if a square you are entering a symbol into maybe needed by some other symbol, which otherwise cannot go anywhere else due to the row/column/section rule violation.</para></listitem>
<listitem><para>If you are having troubles, try to retrace your steps and see exactly where you have made an error.</para></listitem>
<listitem><para>Even though "&kappname;" provides a 'Hint' option for you, try not to use it often. Remember solving the puzzle all by yourself enhances your brain activity, while using the 'Hint' feature too often is cheating.</para></listitem>
<listitem><para>Even though &kappname; provides a 'Hint' option for you, try not to use it often. Remember solving the puzzle all by yourself enhances your brain activity, while using the 'Hint' feature too often is cheating.</para></listitem>
<listitem><para>If you have much trouble solving a certain puzzle, and simply must use the 'Hint' feature, then maybe you should try to decrease the difficulty level, or try a simpler, more basic puzzle.</para></listitem>
<listitem><para>Some puzzle layouts feature very specific game board shapes. It is a good idea to have the coloring option enabled even if you consider yourself an experienced player.</para></listitem>
</itemizedlist>
......@@ -165,7 +165,7 @@
<guimenu>Game</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quits</action> "&kappname;".</para></listitem>
<listitem><para><action>Quits</action> &kappname;.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
......@@ -244,7 +244,7 @@
<guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays a standard &kde; shortcut configuration dialog</action> to change the keyboard shortcuts for "&kappname;".</para></listitem>
<listitem><para><action>Displays a standard &kde; shortcut configuration dialog</action> to change the keyboard shortcuts for &kappname;.</para></listitem>
</varlistentry>
<varlistentry id="settings-menu-toolbar">
<term><menuchoice>
......@@ -256,15 +256,15 @@
<varlistentry id="settings-menu-settings">
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure "&kappname;"...</guimenuitem>
<guimenuitem>Configure &kappname;...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog to configure "&kappname;".</action> See <link linkend="configuration">Game Configuration</link> section for details.</para></listitem>
<listitem><para><action>Opens a dialog to configure &kappname;.</action> See <link linkend="configuration">Game Configuration</link> section for details.</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>
<para>"&kappname;" has a default &kde; <guimenu>Help</guimenu> menu as described
<para>&kappname; has a default &kde; <guimenu>Help</guimenu> menu as described
below, with one addition:</para>
<variablelist>
......@@ -273,7 +273,7 @@ below, with one addition:</para>
<guimenuitem>Home Page</guimenuitem>
</menuchoice></term>
<listitem>
<para>Opens the "&kappname;" website on sourceforge.net in &konqueror;.</para>
<para>Opens the &kappname; website on sourceforge.net in &konqueror;.</para>
</listitem>
</varlistentry>
</variablelist>
......@@ -302,11 +302,11 @@ below, with one addition:</para>
</qandaentry>
<qandaentry>
<question><para>How do I pause the game? </para></question>
<answer><para>"&kappname;" does not have a 'Pause' feature.</para></answer>
<answer><para>&kappname; does not have a 'Pause' feature.</para></answer>
</qandaentry>
<qandaentry>
<question><para>I want to change the way this game looks. Can I? </para></question>
<answer><para>Sudoku games are traditionally played using square grid. Themes would not make much sense here. However, you can select the set of symbols used in game. To do so use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure "&kappname;"...</guimenuitem></menuchoice> on menubar.</para></answer>
<answer><para>Sudoku games are traditionally played using square grid. Themes would not make much sense here. However, you can select the set of symbols used in game. To do so use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kappname;...</guimenuitem></menuchoice> on menubar.</para></answer>
</qandaentry>
<qandaentry>
<question><para>I changed the symbols in the configuration dialog and now my entire game board is filled with question marks. What is the problem?</para></question>
......@@ -318,7 +318,7 @@ below, with one addition:</para>
</qandaentry>
<qandaentry>
<question><para>Can I use keyboard? </para></question>
<answer><para>Yes. In "&kappname;" keyboard play is always enabled. Please use cursor keys to move the selection, numeric characters to enter the symbols and &Shift; key to apply markers.</para></answer>
<answer><para>Yes. In &kappname; keyboard play is always enabled. Please use cursor keys to move the selection, numeric characters to enter the symbols and &Shift; key to apply markers.</para></answer>
</qandaentry>
<qandaentry>
<question><para>I cannot figure out what to do here! Are there hints? </para></question>
......@@ -334,11 +334,11 @@ below, with one addition:</para>
</qandaentry>
<qandaentry>
<question><para>Where are the high scores?</para></question>
<answer><para>"&kappname;" does not have this feature.</para></answer>
<answer><para>&kappname; does not have this feature.</para></answer>
</qandaentry>
<qandaentry>
<question><para>I want to change the game configuration. Where do I go? </para></question>
<answer><para>To access the game settings use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure "&kappname;"...</guimenuitem></menuchoice> on the menubar. See the <link linkend="configuration">Game Configuration</link> section for details.</para></answer>
<answer><para>To access the game settings use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kappname;...</guimenuitem></menuchoice> on the menubar. See the <link linkend="configuration">Game Configuration</link> section for details.</para></answer>
</qandaentry>
<!--Please add more Q&As if needed-->
......@@ -352,7 +352,7 @@ below, with one addition:</para>
<variablelist>
<varlistentry>
<term><guilabel>Show Highlights</guilabel></term>
<listitem><para>Toggle the "&kappname;" highlight option.</para>
<listitem><para>Toggle the &kappname; highlight option.</para>
<note><title>Note:</title><para>Having this option enabled is recommended even for the most experienced players, as it helps to see the actual game board constraints.</para></note></listitem>
</varlistentry>
<varlistentry>
......@@ -393,12 +393,12 @@ below, with one addition:</para>
<!--This chapter is for credits and licenses.-->
<para>
"&kappname;" <!-- do not change this! -->
&kappname; <!-- do not change this! -->
</para>
<!--List all the copyright holders here-->
<para>
"&kappname;" copyright 2005-2007 Francesco Rossi <email>redsh@email.it</email>
&kappname; copyright 2005-2007 Francesco Rossi <email>redsh@email.it</email>
</para>
<para>
Copyright 2006-2007 Mick Kappenburg <email>ksudoku@kappenburg.net</email>, Johannes Bergmeier <email>johannes.bergmeier@gmx.net</email>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment