<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY ksudoku "KSudoku">
  <!ENTITY package "kdegames">  <!-- do not change this! -->
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
  <!ENTITY % addindex "IGNORE"> <!-- do not change this! -->
]>

<book id="ksudoku" lang="&language;"> <!-- do not change this! -->
<bookinfo>
	<title>The &ksudoku; Handbook</title> <!-- This is the title of this docbook. -->
<!-- List of immediate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
	<author>
		<firstname>Mick</firstname>
		<surname>Kappenburg</surname>
		<affiliation><address><email>ksudoku@kappenburg.net</email></address></affiliation>
	</author>
	<author>
		<firstname>Eugene</firstname>
		<surname>Trounev</surname>
		<affiliation><address><email>eugene.trounev@gmail.com</email></address></affiliation>
	</author>
	<author>
		<firstname>Ian</firstname>
		<surname>Wadham</surname>
		<affiliation><address><email>iandw.au@gmail.com</email></address></affiliation>
	</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
	<year>2007</year>
	<holder>Mick Kappenburg</holder>
</copyright>
<copyright>
	<year>2011</year>
	<holder>Ian Wadham</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>2020-12-10</date><!-- Date of (re)writing, or update.-->
<releaseinfo>1.4.20120</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 &ksudoku;, a logic-based symbol placement puzzle.</para>
</abstract>

<!--List of relevant keywords-->
<keywordset>
	<keyword>KDE</keyword> <!-- do not change this! -->
	<keyword>kdegames</keyword> <!-- do not change this! -->
	<keyword>game</keyword> <!-- do not change this! -->
	<keyword>ksudoku</keyword><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword>logic</keyword>
	<keyword>board</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword>one player</keyword>
<!--All other relevant keywords-->
	<keyword>puzzle</keyword>
</keywordset>
</bookinfo>

<!--Content begins here: -->

<chapter id="introduction"><title>Introduction</title> <!-- do not change this! -->

	<note><title>Gametype:</title><para>
		Logic, Board</para></note>

	<note><title>Number of possible players:</title><para>
		One</para></note>

<para>&ksudoku; is a logic-based symbol placement puzzle.</para>

<para>The player has to fill a grid with symbols so that each column, row
	and block on the game board contains only one instance of each
	symbol. In &ksudoku; the symbols are usually the numbers 1 to 9,
	but may be the letters A to P or A to Y in larger puzzles. Puzzles
	start with the board partially filled and it is your job to fill
	in the rest. Some types of puzzle have less than nine symbols.</para>

<para>When you start a game, you can choose from several Sudoku types
	and sizes. You can then have &ksudoku; generate a puzzle for
	you to solve or you can start with an empty board and enter in
	a puzzle from another source, such as a newspaper, then get
	&ksudoku; to check it and maybe solve it.</para>

<para>There are many variations of Sudoku in existence and &ksudoku;
	provides a good selection of them. The most common type, Standard Sudoku, has
	a 9x9 square grid and uses Arabic numerals 1 to 9 as symbols. The
	grid has 9 rows and 9 columns and is divided into 9 blocks of
	3x3 squares. The problem is – each symbol can only be used once
	per row, column or block.</para>

	<note><para>
		It takes time and concentration to complete a game. However,
		solving Sudoku puzzles helps to increase overall brain activity
		and therefore is highly recommended.</para></note>
</chapter>

<chapter id="howto"><title>How to Play</title> <!-- do not change this! -->

	<note><title>Objective:</title><para>
		Fill the grid so that each column, row and block contains only
		one instance of each symbol.</para></note>

<para>When the game starts you are prompted to choose which game type and board
	size you are interested in. You can enter in a puzzle from another
	source or have &ksudoku; generate a puzzle. The generator has several
	difficulty settings and some symmetry settings, which affect
	the pattern in which the puzzle is generated. Your game experience will
	depend on which of all these options you choose.</para>

<para>When the puzzle board appears, take a look at the left hand side. There
	is a selection list which contains all the symbols available in the
	current game. The set of symbols depends on the size of game you
	choose. Games may have 4, 9, 16 or 25 symbols. The first two sets
	use the numbers 1 to 4 or 1 to 9: the others use the letters A to P
	or A to Y.</para>

<para>First, note the boundaries in the game board. The thick lines outline
	the blocks. Each of these blocks has to be completed using the symbols
	available and each symbol must be used once and only once within the
	block. The same is true of the rows and columns in the board.</para>

<para>Now you can start entering symbols into the vacant squares on the board.
	To do that, select the symbol you wish to enter from the selection
	list on the left, then use the mouse to click on a vacant square
	in the board. Alternatively, you can hover with the mouse over a
	vacant square or use the cursor keys to move around,
    then use the keyboard to enter a symbol.</para>

<para>In Roxdoku (three-dimensional) puzzles, always use the mouse to set a
	small cube to a value and use a <emphasis>double</emphasis>
	click. When you rotate the large cube, by clicking and dragging
	with the mouse, it is easier to see what values are on the small
	cubes in the background if you click <emphasis>between</emphasis>
	the small cubes, not on them.</para>

<para>It is useful sometimes to enter markers or notes, which are tiny
	symbols within a square. These have no influence on the solution,
	but they can help you keep track of ideas you have had, especially
	when there is a choice between two alternatives and you do not
	yet have enough information to decide between them. To enter a
	marker or note, click with the &RMB; or hold down the &Shift; key
    when using the keyboard.</para>

<para>To clear symbols from a square, hover over the square with the
	mouse and hit &Del; or &Backspace; on the keyboard or click with
    the &RMB; on the square.</para>

<para>Notice that the squares change color while you hover the mouse over
	them. This is to help you keep up with the rules of &ksudoku;. Use
	the vertical and horizontal lines to check if the symbol you are
	about to enter into a vacant spot is already in use anywhere in
	the vertical or horizontal line that square is a part of. The coloring
	also highlights the block which, if you remember, must also contain
	only one instance of each symbol. If you do not need the highlighting,
	you can use the <menuchoice><guimenu>Settings</guimenu>
	<guimenuitem>Configure &ksudoku;…</guimenuitem></menuchoice>
	menu item to turn it off.</para>

<para>Keep entering symbols in accordance with the rules until the whole
	game field is filled up. At this point &ksudoku; will check if all
	the entries are valid and will either correct you or accept your
	solution.</para>
</chapter>

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

<sect1 id="rules"><title>General Game Rules</title>

<para>The rules of &ksudoku; are quite simple.</para>
	<itemizedlist>
	<listitem><para>Depending on the size of the game board, the type
		of puzzle and the difficulty level chosen an individual
		&ksudoku; puzzle may take from a few minutes 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 column (as defined by the game board)
		can contain each symbol exactly once.</para></listitem>
	<listitem><para>Each block (as defined by the game board) can
		contain each symbol exactly once</para></listitem>
	</itemizedlist>

	<note><title>Note:</title><para>
		The set of symbols depends on the size of game you
		choose.</para></note>

	<itemizedlist>
	<listitem><para>Knowledge of mathematics or language is not required
		to solve &ksudoku; puzzles, but a little ability with 
		arithmetic is needed in Killer Sudoku and Mathdoku 
		puzzles.</para></listitem>
	<listitem><para>The symbols already on the game board when the
		puzzle starts cannot be changed.</para></listitem>
	<listitem><para>You can only modify the symbols you have previously
		entered.</para></listitem>
	<listitem><para>Puzzles generated by &ksudoku; have one solution
		only.</para></listitem>
	<listitem><para>Puzzles you enter in might have no solution or
		more than one solution, but if they are from a published
		source this probably means you have made a data-entry
		error.</para></listitem>
	</itemizedlist>
</sect1>

<sect1 id="variants"><title>&ksudoku; Variations</title>

<sect2 id="standard_sudoku"><title>Sudoku Puzzles</title>

	<itemizedlist>
	<listitem><para>The Standard 9x9 Sudoku puzzle has 9 rows, 9 columns
		and 9 square blocks of size 3x3.</para></listitem>
	<listitem><para>Other sizes of Standard Sudoku are 4x4 (very easy),
		16x16 and 25x25 (not so easy).</para></listitem>
	<listitem><para>The Jigsaw and Aztec variations are the same as 
		Standard 9x9 Sudoku except that some blocks are not square.</para></listitem>
	<listitem><para>The XSudoku variation is exactly the same as Standard
		Sudoku with an additional requirement: the two main
		diagonals must also each contain the symbols 1 to 9 once
		and once only. &ksudoku; highlights the diagonals to make
		this easier to see.</para></listitem>
	<listitem><para>The Nonomino 9x9, Pentomino 5x5 and Tetromino 4x4 
		variations are the same as a Standard Sudoku 
		except that some blocks are not square.</para></listitem>
	<listitem><para>The 6x6 variation is the same as a Standard Sudoku 
		except that the blocks are 
		six 3x2 rectangles.</para></listitem>
	</itemizedlist>
</sect2>

<sect2 id="samurai"><title>Samurai Puzzles</title>

	<itemizedlist>
	<listitem><para>The Samurai Sudoku consists of five Standard Sudoku
		puzzles of 9x9 squares each, overlapping at the corners
		by four 3x3 blocks. Each of the five puzzles has 9 rows,
		9 columns and 9 blocks to solve and the symbols in the 
		overlapping squares must fit into the solutions of two 
		Standard 9x9 Sudokus.</para></listitem>
	<listitem><para>The Tiny Samurai Sudoku contains five 4x4 Sudoku
		puzzles, overlapping at the corners by four squares. Each
		of the five puzzles has 4 rows, 4 columns and 4 blocks to
		solve.</para></listitem>
	<listitem><para>The Windmill variation consists of five Standard 9x9 
		Sudoku puzzles, overlapping at the corners by two 3x3 blocks. 
		It is like a Samurai Sudoku, but the central 9x9 Sudoku is
		harder to see. Eight of its 3x3 blocks are shared with the 
		sails of the windmill and only the central 3x3 block is not.
		</para></listitem>
	<listitem><para>The Sohei variation is another Samurai type and has
		four 9x9 Sudoku puzzles, overlapping at two corners by a 
		3x3 block. The central 3x3 block of the puzzle is empty.
		</para></listitem>
	</itemizedlist>
</sect2>

<sect2 id="roxdoku"><title>Roxdoku 3D Puzzles</title>

	<itemizedlist>
	<listitem><para>The Roxdoku variants are based on cubes in three
		dimensions, but are easier than they sound. There are no
		rows or columns. A 3x3x3 Roxdoku puzzle has 27 small cubes
		arranged into a larger 3x3x3 cube. This contains nine
		slices, each containing 3x3 small cubes, and these are
		the square blocks that must be filled with the numbers
		1 to 9. A 4x4x4 Roxdoku has twelve 4x4 slices and a
		5x5x5 Roxdoku has fifteen 5x5 slices.</para></listitem>
	<listitem><para>The Roxdoku Twin variant has two 3x3x3 Roxdoku 
		puzzles sharing a corner. The corner piece must be part of 
		the solution of both 3x3x3 cubes.</para></listitem>
	<listitem><para>The Double Roxdoku variant contains two 3x3x3
		Roxdoku puzzles sharing three pieces along an edge. The
		edge pieces must be part of the solution of both 3x3x3 cubes.
		</para></listitem>
	<listitem><para>The Samurai Roxdoku variant has nine 3x3x3 Roxdoku
		puzzles. One is at the center and the other eight 3x3x3
		cubes overlap it, one at each of the central cube's corners. 
		Those corner pieces must each be part of the solution of
		two 3x3x3 cubes.</para></listitem>
	</itemizedlist>
</sect2>

<sect2 id="killer"><title>Killer and Mathdoku Variations</title>

	<itemizedlist>
	<listitem><para>Killer puzzles have two variants: Tiny Killer 
		(4x4) and Killer Sudoku (9x9). They both have rows, columns 
		and square blocks, exactly as in Standard Sudoku puzzles 
		and following exactly the same rules. They also have 
		irregularly shaped areas called cages, where each cage's 
		digits must add up to the number in small type in the 
		corner of the cage and no digit can be repeated within 
		the cage. Typically the puzzle starts with only a few 
		squares containing symbols. You need to use arithmetic 
		and the usual Sudoku rules together to work out the 
		solution. The screen graphics make it difficult to 
		visualize the square blocks that are present, but they 
		are easier to see if you print the puzzle, using the 
		<menuchoice><guimenu>Game</guimenu>
		<guimenuitem>Print…</guimenuitem></menuchoice> 
		menu item.</para></listitem>
	<listitem><para>Mathdoku variants, also known as 
                <trademark>Kenken</trademark>, have no blocks, only row and 
		column restrictions, and have cages where the digits 
		must add, subtract, divide or multiply according to the 
		values and arithmetical symbols in small type in their 
		corners. A digit in a Mathdoku cage can be repeated, 
		but not in the same column or row. For example, an 
		L-shape of three squares with a requirement 5+ can have 
		solutions 1 3 1 or 2 1 2, provided the ones or twos are 
		not in the same row or column as each other. Note that 
		subtraction and division cages always have two squares 
		and the two digits of the solution can appear in either 
		order. For example, a 2-cage could have solutions 1 3 
		or 3 1 or 2 4 or 4 2, &etc;</para></listitem>
	<listitem><para>Because there are no blocks in a Mathdoku puzzle, 
		it can have any size from 3x3 up to 9x9, with the default 
		being 6x6. See the
		<link linkend="configuration">Game Configuration</link> 
		section for details. To get you started, there is 
		a variant called Mathdoku 101 of size 4x4.</para></listitem>
	</itemizedlist>
</sect2>
</sect1>

<sect1 id="tips"><title>Strategies and Tips</title>

	<itemizedlist>
	<listitem><para>Take your time and do not rush. &ksudoku; is not
		a quick game.</para></listitem>
	<listitem><para>Pay attention to the row, column, and block
		colorings. They are there to help you.</para></listitem>
	<listitem><para>Make sure that no duplicate symbol exists already
		in the row, column or block where you are entering a
		symbol.</para></listitem>
	<listitem><para>If in doubt, try to foresee if a square you are
		entering a symbol into may be needed by some other symbol,
		which otherwise cannot go anywhere else due to the
		row, column and block rules.</para></listitem>
	<listitem><para>Use the Internet to search for general hints
		and strategies for solving Sudoku puzzles.</para></listitem>
	<listitem><para>Use marker moves when you spot a square or
		squares that have just a few alternatives but you
		cannot decide between them immediately. Markers will
		save you time and memory effort later, when more
		squares have been filled in. See <link linkend="howto">
		How to Play</link> for details of how to use
		markers.</para></listitem>
	<listitem><para>If you are having trouble, try to retrace your
		steps and see exactly where you have made an error. You
		can use the <menuchoice><guimenu>Move</guimenu>
		<guimenuitem>Undo</guimenuitem></menuchoice> and
		<menuchoice><guimenu>Move</guimenu>
		<guimenuitem>Redo</guimenuitem></menuchoice> menu
		items, repeatedly if necessary, and there is a setting
		in <menuchoice><guimenu>Settings</guimenu>
		<guimenuitem>Configure &ksudoku;…</guimenuitem></menuchoice>
		that highlights errors.</para></listitem>
	<listitem><para>Even though &ksudoku; 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 too much trouble solving a certain
		puzzle and simply must use the 'Hint' feature, then
		maybe you should try decreasing 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 highlighting
		option enabled even if you consider yourself an
		experienced player.</para></listitem>
	</itemizedlist>
</sect1>
</chapter>

<chapter id="interface"><title>Interface Overview</title> <!-- do not change this! -->

<sect1 id="welcome-screen"><title>The Welcome Screen</title>

<para>The Welcome Screen is the first thing you see when you start
	&ksudoku; or use the toolbar or menu to request a new game.
	It has a list of all the puzzle types and sizes and you can
	click on one of them to make a selection.</para>

<para>If you click the button marked <guibutton>Enter In A Puzzle</guibutton>, an empty board
	of the selected type and size appears. Here you can use the mouse
	or keyboard to enter in a puzzle from another source, such as
	a newspaper. When you have finished, use the <guilabel>Check</guilabel> action, on
	toolbar or menu, to check the puzzle. It should have just one
	solution. If so, you can start solving the puzzle or perhaps
	get &ksudoku; to solve it. If there is no solution or more
	than one solution, it probably means you have made a data-entry
	error somewhere.</para>

<para>If you click the button marked <guibutton>Generate A Puzzle</guibutton>, &ksudoku;
	will display a board with some squares already filled in. It
	is up to you to fill in the rest.</para>

<para>Before you generate a puzzle, check that the settings of the
	<guilabel>Difficulty:</guilabel> and <guilabel>Symmetry:</guilabel>
	drop down boxes are to your liking. You can change them during a game, but
	then they will have no effect until the next puzzle is
	generated.</para>

	<note><para>If you cannot see the <guilabel>Difficulty:</guilabel> and <guilabel>Symmetry:</guilabel>
		drop down boxes, use the <menuchoice><guimenu>Settings</guimenu>
		<guimenuitem>Show Statusbar</guimenuitem></menuchoice>
		menu item to make sure that the statusbar is
		visible.</para></note>

<para>The <guilabel>Difficulty:</guilabel> drop down box provides six levels of difficulty, from
	<guimenuitem>Very Easy</guimenuitem> up to <guimenuitem>Hard</guimenuitem>,
	<guimenuitem>Diabolical</guimenuitem> and <guimenuitem>Unlimited</guimenuitem>. The easier
	levels may take a few minutes to solve on a 9x9 board. The
	<guimenuitem>Hard</guimenuitem> and <guimenuitem>Diabolical</guimenuitem> levels may take an hour or so and are
	intended to be equivalent to difficult grades appearing in
	newspapers. Samurai puzzles and 16x16 or 25x25 sizes of
	puzzles will take longer to solve, simply because there are
	more rows, columns and blocks and more squares to fill in.</para>

<para>The <guimenuitem>Diabolical</guimenuitem> level typically requires one or more guesses,
	with backtracking if you guess wrong. Lower levels can usually
	be solved by logic alone. The <guimenuitem>Unlimited</guimenuitem> level has no limits
	on the number of guesses required, how soon the first guess
	is needed or how complex the logic might be. It is provided
	for the interest of expert players, but tends to generate
    uninteresting <quote>inhuman</quote> puzzles and is not recommended
    for general use.</para>

 <para>The <guilabel>Symmetry:</guilabel> drop down box provides seven types of symmetry, including
	<guimenuitem>No Symmetry</guimenuitem>. This controls the layout and appearance of the
	squares that are filled in at the start of a puzzle and has
	mainly aesthetic effect, except that puzzles with no symmetry
	tend to be slightly harder than those with high symmetry and
	it is less likely that &ksudoku; can generate a puzzle with
	high difficulty and high symmetry combined.</para>
</sect1>

<!-- 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">
				<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-save">
				<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 as a default save file.</para></listitem>
			</varlistentry>
			<varlistentry id="game-menu-save-as">
				<term><menuchoice>
					<guimenu>Game</guimenu>
					<guimenuitem>Save As…</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Saves</action> the current game as a file of your choice.</para></listitem>
			</varlistentry>
			<varlistentry>
				<term><menuchoice>
					<shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
					<guimenu>Game</guimenu>
					<guimenuitem>Print…</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Prints</action> the
				current state of a two-dimensional game on a printer of your
				choice. The block outlines and original puzzle
				values are printed in black. Other cells,
				filled-in values and solution values are printed
				in gray. There is an option to print just one
				puzzle or more than one puzzle per page. See
				<link linkend="configuration">Game Configuration</link>.</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> &ksudoku;.</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, repeatedly if required.</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> a move that was undone, repeatedly if required.</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>Give a Hint</action> by filling in a vacant square.</para></listitem>
			</varlistentry>
			<varlistentry id="move-menu-demo">
				<term><menuchoice>
					<guimenu>Move</guimenu>
					<guimenuitem>Solve</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Instantly solve</action> the puzzle.</para></listitem>
			</varlistentry>
			<varlistentry id="move-menu-shuffle">
				<term><menuchoice>
					<guimenu>Move</guimenu>
					<guimenuitem>Check</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Check</action> an entered puzzle for validity. If it has only one solution, it becomes available for play. If it has no solution or more than one solution, there has probably been an error in the data-entry.</para></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="settings-menu">
	<title>The Settings Menu</title>
		<variablelist>
			<varlistentry id="settings-menu-settings">
				<term><menuchoice>
					<guimenu>Settings</guimenu>
					<guimenuitem>Configure &ksudoku;…</guimenuitem>
				</menuchoice></term>
				<listitem><para><action>Open a dialog to configure &ksudoku;.</action> See <link linkend="configuration">Game Configuration</link> section for details.</para></listitem>
			</varlistentry>
		</variablelist>
		<para>
		  Additionally &ksudoku; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
		  menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> and
		  <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
		  of the &kde; Fundamentals.
		</para>
</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>Sudoku games are traditionally played using a square grid. Themes do not make much sense here, but you can select some color schemes and backgrounds. To do so use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &ksudoku;…</guimenuitem></menuchoice> on the menubar.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Can I use the keyboard to play this game? </para></question>
 <answer><para>Yes. In &ksudoku; keyboard play is always enabled. Please use the cursor keys to move the selection, numeric or alphabetic characters to enter the symbols and the &Shift; key to apply markers.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Where are the high scores?</para></question>
 <answer><para>&ksudoku; does not have this feature.</para></answer>
</qandaentry>
<!--Please add more Q&As if needed-->

</qandaset>
</chapter>

<chapter id="configuration"><title>Game Configuration</title> <!-- do not change this! -->
<!--This section describes configuration GUI. If your game is configured using menubar exclusively, please remove this section.-->

<sect1 id="general-options"><title>Game Options</title>
	<variablelist>
		<varlistentry>
			<term><guilabel>When printing, try to fit more than one puzzle on a page</guilabel></term>
			<listitem>
			<para>Toggle the option to print more than one puzzle per page whenever they will fit.</para>
			<para>If this option is checked, puzzles will be printed when no more will fit on a page 
			      or when &ksudoku; terminates. Otherwise a puzzle is printed immediately.</para>
			<para>Three-dimensional puzzles cannot be printed.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term><guilabel>Show Highlights in 2-D puzzles</guilabel></term>
			<listitem><para>Toggle the &ksudoku; highlight option for two-dimensional puzzles.</para></listitem>
		</varlistentry>
		<varlistentry>
			<term><guilabel>Show Errors</guilabel></term>
			<listitem><para>Toggle the option to highlight errors.</para></listitem>
		</varlistentry>
		<varlistentry>
			<term><guilabel>Show Highlights in 3-D puzzles</guilabel></term>
			<listitem><para>Toggle the &ksudoku; highlight option for three-dimensional puzzles.</para></listitem>
		</varlistentry>
		<varlistentry>
			<term><guilabel>Mathdoku puzzle size (3-9)</guilabel></term>
			<listitem><para>Choose a size for Mathdoku puzzles, from 3 (very easy) to 9 (very hard) with size 6 being the default.</para></listitem>
		</varlistentry>
		<varlistentry>
			<term><guilabel>Settings for 3-D Puzzles Only</guilabel></term>
			<listitem><para>These five settings adjust the highlighting and visibility of cells in three-dimensional puzzles. The idea is to make it easier to see relationships between cells, especially if they are behind other cells.</para></listitem>
		</varlistentry>
	</variablelist>
		<note><title>Note:</title><para>Having the highlighting options enabled is recommended even for the most experienced players, as it helps you see the actual game board constraints.</para></note>
</sect1>
</chapter>

<chapter id="credits"><title>Credits and License</title> <!-- do not change this! -->

<para>
&ksudoku;  <!-- do not change this! -->
</para>

<!--List all the copyright holders here-->
<para>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></para>

<para>Copyright 2011 Ian Wadham <email>iandw.au@gmail.com</email></para>

<para>New solver and generator algorithms 2011 David Bau, <ulink
	url="http://davidbau.com/archives/2006/09/04/sudoku_generator.html">
	see website.</ulink></para>

<para>Documentation copyright 2005 Francesco Rossi
	<email>redsh@email.it</email></para>

<para>Documentation copyright 2007 Mick Kappenburg
	<email>ksudoku@kappenburg.net</email>,
	Eugene Trounev <email>eugene.trounev@gmail.com</email></para>

<para>Documentation copyright 2011-2020 Ian Wadham
	<email>iandw.au@gmail.com</email></para>

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

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

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