Ensure that an old random seed isn't left around for the user to see when a

[sgt/puzzles] / puzzles.but

diff --git a/puzzles.but b/puzzles.but
index 17bf476..fa7ce1a 100644 (file)
--- a/puzzles.but
+++ b/puzzles.but
@@ -90,18 +90,18 @@ menu}\q{Edit} menus instead.)
 
 \dd Starts a new game, with a random initial state.
 
 
 \dd Starts a new game, with a random initial state.
 

-\dt \ii\e{Restart game} (\q{R})
+\dt \ii\e{Restart game}

 
 

-\dd Resets the current game to its initial state. Undo is lost.
+\dd Resets the current game to its initial state. (This can be undone.)

 
 \dt \ii\e{Undo} (\q{U}, Ctrl+\q{Z}, Ctrl+\q{_})
 
 \dd Undoes a single move. (You can undo moves back to the start of the
 
 \dt \ii\e{Undo} (\q{U}, Ctrl+\q{Z}, Ctrl+\q{_})
 
 \dd Undoes a single move. (You can undo moves back to the start of the

-game.)
+session.)

 
 

-\dt \ii\e{Redo} (Ctrl+\q{R})
+\dt \ii\e{Redo} (\q{R}, Ctrl+\q{R})

 
 

-\dd Redoes a previous undone move.
+\dd Redoes a previously undone move.

 
 \dt \ii\e{Copy}
 
 
 \dt \ii\e{Copy}
 


@@ -361,6 +361,15 @@ from the original Net window.
 
 }
 
 
 }
 

+\dt \e{Ensure unique solution}
+
+\dd Normally, Net will make sure that the puzzles it presents have
+only one solution. Puzzles with ambiguous sections can be more
+difficult and more subtle, so if you like you can turn off this
+feature and risk having ambiguous puzzles. (Also, finding \e{all}
+the possible solutions can be an additional challenge for an
+advanced player.)
+

 \C{cube} \i{Cube}
 
 \cfg{winhelp-topic}{games.cube}
 \C{cube} \i{Cube}
 
 \cfg{winhelp-topic}{games.cube}


@@ -578,13 +587,13 @@ numbered square, and (b) the area of each rectangle is equal to the
 number written in its numbered square.
 
 Credit for this game goes to the Japanese puzzle magazine \i{Nikoli}
 number written in its numbered square.
 
 Credit for this game goes to the Japanese puzzle magazine \i{Nikoli}

-\k{nikoli-rect}; I've also seen a Palm implementation at \i{Puzzle Palace}
-\k{puzzle-palace-rect}. Unlike Puzzle Palace's implementation, my version
-automatically generates random grids of any size you like. The quality
-of puzzle design is therefore not quite as good as hand-crafted
-puzzles would be (in particular, a unique solution cannot be
-guaranteed), but on the plus side you get an inexhaustible supply of
-puzzles tailored to your own specification.
+\k{nikoli-rect}; I've also seen a Palm implementation at \i{Puzzle
+Palace} \k{puzzle-palace-rect}. Unlike Puzzle Palace's
+implementation, my version automatically generates random grids of
+any size you like. The quality of puzzle design is therefore not
+quite as good as hand-crafted puzzles would be, but on the plus side
+you get an inexhaustible supply of puzzles tailored to your own
+specification.

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


@@ -604,15 +613,23 @@ When a rectangle of the correct size is completed, it will be shaded.
 
 \H{rectangles-params} \I{parameters, for Rectangles}Rectangles parameters
 
 
 \H{rectangles-params} \I{parameters, for Rectangles}Rectangles parameters
 

-The \q{Custom...} option on the \q{Type} menu offers you \e{Width}
-and \e{Height} parameters, which are self-explanatory.
+These parameters are available from the \q{Custom...} option on the
+\q{Type} menu.
+
+\dt \e{Width}, \e{Height}
+
+\dd Size of grid, in squares.

 
 

-\q{Expansion factor} is a mechanism for changing the type of grids
-generated by the program. Some people prefer a grid containing a few
-large rectangles to one containing many small ones. So you can ask
+\dt \e{Expansion factor}
+
+\dd This is a mechanism for changing the type of grids generated by
+the program. Some people prefer a grid containing a few large
+rectangles to one containing many small ones. So you can ask

 Rectangles to essentially generate a \e{smaller} grid than the size
 you specified, and then to expand it by adding rows and columns.
 
 Rectangles to essentially generate a \e{smaller} grid than the size
 you specified, and then to expand it by adding rows and columns.
 

+\lcont{
+

 The default expansion factor of zero means that Rectangles will
 simply generate a grid of the size you ask for, and do nothing
 further. If you set an expansion factor of (say) 0.5, it means that
 The default expansion factor of zero means that Rectangles will
 simply generate a grid of the size you ask for, and do nothing
 further. If you set an expansion factor of (say) 0.5, it means that


@@ -627,6 +644,17 @@ and more intuitive playing style. If you set it \e{too} high,
 though, the game simply cannot generate more than a few rectangles
 to cover the entire grid, and the game becomes trivial.
 
 though, the game simply cannot generate more than a few rectangles
 to cover the entire grid, and the game becomes trivial.
 

+}
+
+\dt \e{Ensure unique solution}
+
+\dd Normally, Rectangles will make sure that the puzzles it presents
+have only one solution. Puzzles with ambiguous sections can be more
+difficult and more subtle, so if you like you can turn off this
+feature and risk having ambiguous puzzles. Also, finding \e{all} the
+possible solutions can be an additional challenge for an advanced
+player. Turning off this option can also speed up puzzle generation.
+

 
 \C{netslide} \i{Netslide}
 
 
 \C{netslide} \i{Netslide}