[games/ksudoku] doc: Document rules for the new games (patch by Ian Wadham, with minor corrections)
Yuri Chornoivan
null at kde.org
Fri May 22 07:34:15 BST 2020
Git commit 56f6d4e23da079a9ea83796644927a6b931c7287 by Yuri Chornoivan.
Committed on 22/05/2020 at 06:34.
Pushed by yurchor into branch 'master'.
Document rules for the new games (patch by Ian Wadham, with minor corrections)
M +110 -18 doc/index.docbook
https://invent.kde.org/games/ksudoku/commit/56f6d4e23da079a9ea83796644927a6b931c7287
diff --git a/doc/index.docbook b/doc/index.docbook
index f1cef31..45f922f 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -41,8 +41,8 @@
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
-<date>2013-12-18</date><!-- Date of (re)writing, or update.-->
-<releaseinfo>1.2.1 (&kde; 4.12)</releaseinfo><!-- Application version number. Use the variable definitions within header to change this value.-->
+<date>2020-05-21</date><!-- Date of (re)writing, or update.-->
+<releaseinfo>1.4.200400</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>
@@ -82,7 +82,7 @@
symbol. In &kappname; 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.</para>
+ 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 &kappname; generate a puzzle for
@@ -91,7 +91,7 @@
&kappname; to check it and maybe solve it.</para>
<para>There are many variations of Sudoku in existence and &kappname;
- provides a good selection of them. The most common variant has
+ 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
@@ -197,7 +197,9 @@
<itemizedlist>
<listitem><para>Knowledge of mathematics or language is not required
- to solve &kappname; puzzles.</para></listitem>
+ to solve &kappname; 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
@@ -213,19 +215,59 @@
<sect1 id="variants"><title>&kappname; 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 variation is the same as Standard Sudoku
- except that some blocks are not square.</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. &kappname; highlights the diagonals to make
this easier to see.</para></listitem>
- <listitem><para>The Roxdoku variations are based on cubes in three
+ <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
@@ -233,16 +275,62 @@
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 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
- and 9 columns to solve, but there are only 41 blocks to
- solve, rather than 45, because of the overlap.</para></listitem>
- <listitem><para>The Tiny Samurai Sudoku consists of five 4x4
- 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 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>
@@ -528,6 +616,10 @@
<term><guilabel>Show Highlights in 3-D puzzles</guilabel></term>
<listitem><para>Toggle the &kappname; 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>
@@ -562,7 +654,7 @@
<email>ksudoku at kappenburg.net</email>,
Eugene Trounev <email>eugene.trounev at gmail.com</email></para>
-<para>Documentation copyright 2011 Ian Wadham
+<para>Documentation copyright 2011-2020 Ian Wadham
<email>iandw.au at gmail.com</email></para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
More information about the kde-doc-english
mailing list