Introduce some infrastructure to permit games' print functions to

[sgt/puzzles] / puzzles.but

diff --git a/puzzles.but b/puzzles.but
index 32f331a..40cfdae 100644 (file)
--- a/puzzles.but
+++ b/puzzles.but
@@ -707,6 +707,11 @@ the centre tile of the square you want to rotate.
 Clicking with the left mouse button rotates the group anticlockwise.
 Clicking with the right button rotates it clockwise.
 
 Clicking with the left mouse button rotates the group anticlockwise.
 Clicking with the right button rotates it clockwise.
 

+You can also move an outline square around the grid with the cursor
+keys; the square is the size above (2\by\.2 by default, or larger).
+Pressing the return key or space bar will rotate the current square
+anticlockwise or clockwise respectively.
+

 (All the actions described in \k{common-actions} are also available.)
 
 \H{twiddle-parameters} \I{parameters, for Twiddle}Twiddle parameters
 (All the actions described in \k{common-actions} are also available.)
 
 \H{twiddle-parameters} \I{parameters, for Twiddle}Twiddle parameters


@@ -1578,9 +1583,13 @@ right-clicking; whole rows and columns may be similarly locked by
 right-clicking in the laser firing range above/below that column, or
 to the left/right of that row.  
 
 right-clicking in the laser firing range above/below that column, or
 to the left/right of that row.  
 

+The cursor keys may also be used to move around the grid. Pressing the
+Enter key will add a new ball-location guess, and pressing Space will
+lock a cell or a row/column.
+

 When an appropriate number of balls have been guessed a button will
 When an appropriate number of balls have been guessed a button will

-appear at the top-left corner of the grid; clicking that will mark
-your guesses. 
+appear at the top-left corner of the grid; clicking that (with mouse or
+cursor) will mark your guesses. 

 
 If you click the \q{mark} button and your guesses are not correct,
 the game will show you as little information as possible to
 
 If you click the \q{mark} button and your guesses are not correct,
 the game will show you as little information as possible to


@@ -2126,6 +2135,15 @@ will be prevented from accidentally modifying any of those bridges
 in future. Left-clicking again on a highlighted island will unmark
 it and restore your ability to modify it.
 
 in future. Left-clicking again on a highlighted island will unmark
 it and restore your ability to modify it.
 

+You can also use the cursor keys to move around the grid: if possible
+the cursor will always move orthogonally, otherwise it will move
+towards the nearest island to the indicated direction. Pressing the
+return key followed by a cursor key will lay an island in that direction
+(if available); pressing the space bar followed by a cursor key will
+lay a \q{non-bridge} marker.
+
+You can mark an island as finished by pressing the return key twice.
+

 Violations of the puzzle rules will be marked in red:
 
 \b An island with too many bridges will be highlighted in red.
 Violations of the puzzle rules will be marked in red:
 
 \b An island with too many bridges will be highlighted in red.