Document keyboard controls for Flip

[sgt/puzzles] / puzzles.but

diff --git a/puzzles.but b/puzzles.but
index 42964ff..57dc3b5 100644 (file)
--- a/puzzles.but
+++ b/puzzles.but
@@ -94,6 +94,22 @@ menu}\q{Edit} menus instead.)
 
 \dd Resets the current game to its initial state. (This can be undone.)
 
+\dt \ii\e{Load}
+
+\dd Loads a saved game from a file on disk.
+
+\dt \ii\e{Save}
+
+\dd Saves the current state of your game to a file on disk.
+
+\lcont{
+
+The Load and Save operations should preserve your entire game
+history (so you can save, reload, and still Undo and Redo things you
+had done before saving).
+
+}
+
 \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
@@ -1011,7 +1027,11 @@ change when you flip it.
 \IM{Flip controls} keys, for Flip
 \IM{Flip controls} shortcuts (keyboard), for Flip
 
-Left-click in a square to flip it and its associated squares.
+This game can be played with either the keyboard or the mouse.
+
+Left-click in a square to flip it and its associated squares, or
+use the cursor keys to choose a square and the space bar or Enter
+key to flip.
 
 If you use the \q{Solve} function on this game, it will mark some of
 the squares in red. If you click once in every square with a red
@@ -1065,9 +1085,10 @@ Guess was contributed to this collection by James Harvey.
 
 This game can be played with either the keyboard or the mouse.
 
-With the mouse, drag a peg from the tray on the left-hand side to its
-required position in the current guess; pegs may also be dragged from
-current and past guesses to copy them elsewhere.
+With the mouse, drag a coloured peg from the tray on the left-hand
+side to its required position in the current guess; pegs may also be
+dragged from current and past guesses to copy them elsewhere. To
+remove a peg, drag it off its current position to somewhere invalid.
 
 Right-clicking in the current guess adds a \q{hold} marker; pegs
 that have hold markers will be automatically added to the next guess
@@ -1075,17 +1096,19 @@ after marking.
 
 Alternatively, with the keyboard, the up and down cursor keys can be
 used to select a peg colour, the left and right keys to select a
-peg position, and the space bar to place a peg of the selected colour
-in the chosen position. \q{H} adds a hold marker.
+peg position, and the space bar or Enter key to place a peg of the
+selected colour in the chosen position. \q{D} or Backspace removes a
+peg, and \q{H} adds a hold marker.
 
-When the guess is complete, the feedback pegs will be highlighted;
+When the guess is complete, the smaller feedback pegs will be highlighted;
 clicking on these (or moving the peg cursor to them with the arrow keys
-and pressing the space bar) will mark the current guess, copy any held pegs
-to the next guess, and move the \q{current guess} marker.
+and pressing the space bar or Enter key) will mark the current guess,
+copy any held pegs to the next guess, and move the \q{current guess}
+marker.
 
 If you correctly position all the pegs the solution will be displayed
 below; if you run out of guesses (or select \q{Solve...}) the solution
-will also be revealed. 
+will also be revealed.
 
 \H{guess-parameters} \I{parameters, for guess}Guess parameters