Formatting tweaks / index terms in Unequal docs.

[sgt/puzzles] / puzzles.but

diff --git a/puzzles.but b/puzzles.but
index 9c58b9f..3830003 100644 (file)
--- a/puzzles.but
+++ b/puzzles.but
@@ -24,7 +24,7 @@
 
 This is a collection of small one-player puzzle games.
 
 
 This is a collection of small one-player puzzle games.
 

-\copyright This manual is copyright 2004-5 Simon Tatham. All rights
+\copyright This manual is copyright 2004-2007 Simon Tatham. All rights

 reserved. You may distribute this documentation under the MIT licence.
 See \k{licence} for the licence text in full.
 
 reserved. You may distribute this documentation under the MIT licence.
 See \k{licence} for the licence text in full.
 


@@ -105,7 +105,7 @@ menu}\q{Edit} menus instead.)
 
 \lcont{
 
 
 \lcont{
 

-The Load and Save operations should preserve your entire game
+The Load and Save operations preserve your entire game

 history (so you can save, reload, and still Undo and Redo things you
 had done before saving).
 
 history (so you can save, reload, and still Undo and Redo things you
 had done before saving).
 


@@ -308,8 +308,17 @@ missing. See \k{common-id} for more details on this.)
 
 (This section only applies to the Unix port.)
 
 
 (This section only applies to the Unix port.)
 

-In addition to specifying game parameters on the command line (see
-\k{common-cmdline}), you can also specify various options:
+In addition to being able to specify game parameters on the command
+line (see \k{common-cmdline}), there are various other options:
+
+\dt \cw{--game}
+
+\dt \cw{--load}
+
+\dd These options respectively determine whether the command-line
+argument is treated as specifying game parameters or a \i{save} file
+to \i{load}. Only one should be specified. If neither of these options
+is specified, a guess is made based on the format of the argument.

 
 \dt \cw{--generate }\e{n}
 
 
 \dt \cw{--generate }\e{n}
 


@@ -875,12 +884,18 @@ additional digits will be letters of the alphabet. For example, if
 you select 3\by\.4 then the digits which go in your grid will be 1
 to 9, plus \cq{a}, \cq{b} and \cq{c}.
 
 you select 3\by\.4 then the digits which go in your grid will be 1
 to 9, plus \cq{a}, \cq{b} and \cq{c}.
 

-I first saw this puzzle in \i{Nikoli} \k{nikoli-solo}, although it's also
-been popularised by various newspapers under the name \q{\i{Sudoku}} or
-\q{Su Doku}.
+I first saw this puzzle in \i{Nikoli} \k{nikoli-solo}, although it's
+also been popularised by various newspapers under the name
+\q{Sudoku} or \q{Su Doku}.  Howard Garns is considered the inventor
+of the modern form of the puzzle, and it was first published in
+\e{Dell Pencil Puzzles and Word Games}.  A more elaborate treatment
+of the history of the puzzle can be found on Wikipedia
+\k{wikipedia-solo}.

 
 \B{nikoli-solo} \W{http://www.nikoli.co.jp/puzzles/1/index_text-e.htm}\cw{http://www.nikoli.co.jp/puzzles/1/index_text-e.htm}
 
 
 \B{nikoli-solo} \W{http://www.nikoli.co.jp/puzzles/1/index_text-e.htm}\cw{http://www.nikoli.co.jp/puzzles/1/index_text-e.htm}
 

+\B{wikipedia-solo} \W{http://en.wikipedia.org/wiki/Sudoku}\cw{http://en.wikipedia.org/wiki/Sudoku}
+

 \H{solo-controls} \I{controls, for Solo}Solo controls
 
 To play Solo, simply click the mouse in any empty square and then
 \H{solo-controls} \I{controls, for Solo}Solo controls
 
 To play Solo, simply click the mouse in any empty square and then


@@ -1801,20 +1816,11 @@ These parameters are available from the \q{Custom...} option on the
 
 \dd Size of grid in squares.
 
 
 \dd Size of grid in squares.
 

-\dt \e{Recursion depth}
-
-\dd Determines how much guesswork and backtracking you will need to
-do to solve the puzzle. When this is set to zero (as it is for all
-of the \q{Easy} options in the menu), you should always be able to
-deduce the state of an edge without having to guess. If you increase
-it, you will have to guess more and more.
-
-\lcont{
-
-Setting a high value for this option is liable to consume a lot of
-CPU time and memory. Be warned!
+\dt \e{Difficulty}

 
 

-}
+\dd Controls the difficulty of the generated puzzle.
+\#{FIXME: what distinguishes Easy, Medium, and Hard? In particular,
+when are backtracking/guesswork required, if ever?}

 
 
 \C{inertia} \i{Inertia}
 
 
 \C{inertia} \i{Inertia}


@@ -2067,9 +2073,78 @@ possible islands; low expansion factors can create lots of
 tightly-packed islands.
 
 
 tightly-packed islands.
 
 

+\C{unequal} \i{Unequal}
+
+\cfg{winhelp-topic}{games.unequal}
+
+You have a square grid; each square may contain a digit from 1 to
+the size of the grid, and some squares have greater-than signs between
+them. Your aim is to fully populate the grid with numbers such that:
+
+\b Each row contains only one occurrence of each digit
+
+\b Each column contains only one occurrence of each digit
+
+\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.
+
+At the time of writing, this puzzle is appearing in the Guardian
+weekly under the name \q{\i{Futoshiki}}.
+
+Unequal was contributed to this collection by James Harvey.
+
+\H{unequal-controls} \i{Unequal controls}
+
+\IM{Unequal controls} controls, for Unequal
+
+Unequal shares much of its control system with Solo.
+
+To play Unequal, simply click the mouse in any empty square and then
+type a digit or letter on the keyboard to fill that square. If you
+make a mistake, click the mouse in the incorrect square and press
+Space to clear it again (or use the Undo feature).
+
+If you \e{right}-click in a square and then type a number, that
+number will be entered in the square as a \q{pencil mark}. You can
+have pencil marks for multiple numbers in the same square.
+
+The game pays no attention to pencil marks, so exactly what you use
+them for is up to you: you can use them as reminders that a
+particular square needs to be re-examined once you know more about a
+particular number, or you can use them as lists of the possible
+numbers in a given square, or anything else you feel like.
+
+To erase a single pencil mark, right-click in the square and type
+the same number again.
+
+All pencil marks in a square are erased when you left-click and type
+a number, or when you left-click and press space. Right-clicking and
+pressing space will also erase pencil marks.
+
+(All the actions described in \k{common-actions} are also available.)
+
+\H{unequal-parameters} \I{parameters, for Unequal}Unequal parameters
+
+These parameters are available from the \q{Custom...} option on the
+\q{Type} menu.
+
+\dt \e{Size (s*s)}
+
+\dd Size of grid.
+
+\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 Tricky level, some recursion may be required (but the
+solutions should always be unique).
+
+

 \A{licence} \I{MIT licence}\ii{Licence}
 
 \A{licence} \I{MIT licence}\ii{Licence}
 

-This software is \i{copyright} 2004-2005 Simon Tatham.
+This software is \i{copyright} 2004-2007 Simon Tatham.

 
 Portions copyright Richard Boulton, James Harvey and Mike Pinna.
 
 
 Portions copyright Richard Boulton, James Harvey and Mike Pinna.