--- Games-Go-SimpleBoard/SimpleBoard.pm	2008/06/22 15:05:59	1.1
+++ Games-Go-SimpleBoard/SimpleBoard.pm	2008/06/23 00:38:35	1.2
@@ -131,14 +131,14 @@
    @found
 }
 
-=item $hint = $board->update ([update-structure...])
+=item $hint = $board->update ([update-structures...])
 
-Structure is
+Each update-structure itself is also an array-ref:
 
    [$x, $y, $clr, $set, $label, $hint] # update or move
    []                                  # pass
 
-and changes the board or executes a move, by first clearing the bits
+It changes the board or executes a move, by first clearing the bits
 specified in C<$clr>, then setting bits specified in C<$set>.
 
 If C<$set> includes C<MARK_LABEL>, the label text must be given in
@@ -150,6 +150,12 @@
 If the hint member is a reference the scalar pointed to by the reference
 is updated instead.
 
+If all this hint member thing is unclear, just ignore it and specify it
+as C<undef> or leave it out of the array entirely. Do make sure that you
+keep your update structures around, however, as regenerating a full board
+position from hinted update structures is I<much> faster then recreating
+it from fresh update structures.
+
 Example, make two silly moves:
 
   $board->update ([[0, 18, -1, MARK_B|MARK_MOVE],