Michael Schierl's patch to compile the puzzles as Java applets using
[sgt/puzzles] / puzzles.but
index 85b497d..5c231df 100644 (file)
@@ -24,7 +24,7 @@
 
 This is a collection of small one-player puzzle games.
 
-\copyright This manual is copyright 2004-2007 Simon Tatham. All rights
+\copyright This manual is copyright 2004-2008 Simon Tatham. All rights
 reserved. You may distribute this documentation under the MIT licence.
 See \k{licence} for the licence text in full.
 
@@ -861,9 +861,9 @@ menu are \e{Width} and \e{Height}, which are self-explanatory.
 
 \cfg{winhelp-topic}{games.solo}
 
-You have a square grid, which is divided into square or rectangular
-blocks. Each square must be filled in with a digit from 1 to the
-size of the grid, in such a way that
+You have a square grid, which is divided into as many equally sized
+sub-blocks as the grid has rows. Each square must be filled in with
+a digit from 1 to the size of the grid, in such a way that
 
 \b every row contains only one occurrence of each digit
 
@@ -871,13 +871,19 @@ size of the grid, in such a way that
 
 \b every block contains only one occurrence of each digit.
 
+\b (optionally, by default off) each of the square's two main
+diagonals contains only one occurrence of each digit.
+
 You are given some of the numbers as clues; your aim is to place the
 rest of the numbers correctly.
 
-The default puzzle size is 3\by\.3 (a 9\by\.9 actual grid, divided
-into nine 3\by\.3 blocks). You can also select sizes with
-rectangular blocks instead of square ones, such as 2\by\.3 (a
-6\by\.6 grid divided into six 3\by\.2 blocks).
+Under the default settings, the sub-blocks are square or
+rectangular. The default puzzle size is 3\by\.3 (a 9\by\.9 actual
+grid, divided into nine 3\by\.3 blocks). You can also select sizes
+with rectangular blocks instead of square ones, such as 2\by\.3 (a
+6\by\.6 grid divided into six 3\by\.2 blocks). Alternatively, you
+can select \q{jigsaw} mode, in which the sub-blocks are arbitrary
+shapes which differ between individual puzzles.
 
 If you select a puzzle size which requires more than 9 digits, the
 additional digits will be letters of the alphabet. For example, if
@@ -930,6 +936,19 @@ rows, into which the main grid is divided. (The size of a block is
 the inverse of this: for example, if you select 2 columns and 3 rows,
 each actual block will have 3 columns and 2 rows.)
 
+If you tick the \q{X} checkbox, Solo will apply the optional extra
+constraint that the two main diagonals of the grid also contain one
+of every digit. (This is sometimes known as \q{Sudoku-X} in
+newspapers.) In this mode, the squares on the two main diagonals
+will be shaded slightly so that you know it's enabled.
+
+If you tick the \q{Jigsaw} checkbox, Solo will generate randomly
+shaped sub-blocks. In this mode, the actual grid size will be taken
+to be the product of the numbers entered in the \q{Columns} and
+\q{Rows} boxes. There is no reason why you have to enter a number
+greater than 1 in both boxes; Jigsaw mode has no constraint on the
+grid size, and it can even be a prime number if you feel like it.
+
 You can also configure the type of symmetry shown in the generated
 puzzles. More symmetry makes the puzzles look prettier but may also
 make them easier, since the symmetry constraints can force more
@@ -2087,8 +2106,9 @@ them. Your aim is to fully populate the grid with numbers such that:
 
 \b All the greater-than signs are satisfied. 
 
-In \q{Trivial} mode, there are no greater-than signs; the puzzle is
-to solve the \i{Latin square} only.
+In \q{Trivial} mode (available via the \q{Custom} game type
+selector), there are no greater-than signs; the puzzle is to solve
+the \i{Latin square} only.
 
 At the time of writing, this puzzle is appearing in the Guardian
 weekly under the name \q{\i{Futoshiki}}.
@@ -2137,10 +2157,11 @@ These parameters are available from the \q{Custom...} option on the
 \dt \e{Difficulty}
 
 \dd Controls the difficulty of the generated puzzle. At Trivial
-level, there are no greater-than signs (the puzzle is to solve the
-Latin square only); at Recursive level backtracking will be required
-(but the solution should still be unique); the levels in between
-require increasingly complex reasoning to avoid having to backtrack.
+level, there are no greater-than signs; the puzzle is to solve the
+Latin square only. At Recursive level (only available via the
+\q{Custom} game type selector) backtracking will be required, but
+the solution should still be unique. The levels in between require
+increasingly complex reasoning to avoid having to backtrack.
 
 
 
@@ -2231,9 +2252,11 @@ Filling was contributed to this collection by Jonas K\u00F6{oe}lker.
 \H{filling-controls} \I{controls, for Filling}Filling controls
 
 To play Filling, simply click the mouse in any empty square and then
-type a digit on the keyboard to fill that square.  If you make a
-mistake, click the mouse in the incorrect square and press 0, Space,
-Backspace or Enter to clear it again (or use the Undo feature).
+type a digit on the keyboard to fill that square. By dragging the
+mouse, you can select multiple squares to fill with a single keypress.
+If you make a mistake, click the mouse in the incorrect square and
+press 0, Space, Backspace or Enter to clear it again (or use the Undo
+feature).
 
 (All the actions described in \k{common-actions} are also available.)
 
@@ -2246,10 +2269,10 @@ grid, through the \q{Type} menu.
 
 \A{licence} \I{MIT licence}\ii{Licence}
 
-This software is \i{copyright} 2004-2007 Simon Tatham.
+This software is \i{copyright} 2004-2008 Simon Tatham.
 
-Portions copyright Richard Boulton, James Harvey, Mike Pinna and
-Jonas K\u00F6{oe}lker.
+Portions copyright Richard Boulton, James Harvey, Mike Pinna, Jonas
+K\u00F6{oe}lker, Dariusz Olszewski and Michael Schierl.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation files