X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/puzzles/blobdiff_plain/e91825f8e43648bf129dae18809ee2e38af70d33..c87ce51a9ebefaed64048dcd86aed546b930779d:/puzzles.but

diff --git a/puzzles.but b/puzzles.but
index 2d10605..15f73c5 100644
--- a/puzzles.but
+++ b/puzzles.but
@@ -22,7 +22,7 @@ This is a collection of small one-player puzzle games.
 reserved. You may distribute this documentation under the MIT licence.
 See \k{licence} for the licence text in full.
 
-\versionid $Id: puzzles.but,v 1.1 2004/08/16 12:23:56 simon Exp $
+\versionid $Id$
 
 
 \C{intro} Introduction
@@ -406,10 +406,56 @@ When a rectangle of the correct size is completed, it will be shaded.
 
 \H{rectangles-params} \I{parameters, for Rectangles}Rectangles parameters
 
-The only parameters available from the \q{Custom...} option on the
-\q{Type} menu are \e{Width} and \e{Height}, which are
-self-explanatory.
-
+The \q{Custom...} option on the \q{Type} menu offers you \e{Width}
+and \e{Height} parameters, which are self-explanatory.
+
+\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
+Rectangles to essentially generate a \e{smaller} grid than the size
+you specified, and then to expand it by adding rows and columns.
+
+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
+each dimension of the grid will be expanded to half again as big
+after generation. In other words, the initial grid will be 2/3 the
+size in each dimension, and will be expanded to its full size
+without adding any more rectangles.
+
+Setting an expansion factor of around 0.5 tends to make the game
+more difficult, and also (in my experience) rewards a less deductive
+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.
+
+\H{rectangles-cmdline} \I{command line, for Rectangles}Additional
+command-line configuration
+
+The expansion factor parameter, described in \k{rectangles-params},
+is not mentioned by default in the game ID (see \k{common-id}). So
+if you set your expansion factor to (say) 0.75, and then you
+generate an 11x11 grid, then the game ID will simply say
+\c{11x11:}\e{numbers}. This means that if you send the game ID to
+another player and they paste it into their copy of Rectangles,
+their game will not be automatically configured to use the same
+expansion factor in any subsequent grids it generates. (I don't
+think the average person examining a single grid sent to them by
+another player would want their configuration modified to that
+extent.)
+
+If you are specifying a game ID or game parameters on the command
+line (see \k{common-cmdline}) and you do want to configure the
+expansion factor, you can do it by suffixing the letter \cq{e} to
+the parameters, followed by the expansion factor as a decimal
+number. For example:
+
+\b \cq{rect 11x11e0.75} starts Rectangles with a grid size of
+11\u00d7{x}11 and an expansion factor of 0.75.
+
+\b \cq{rect 11x11e0.75:g11c6e5e4a2_4e9c3b3d3b5g2b6c4k4g30a8n3j1g6a2}
+starts Rectangles with a grid size of 11\u00d7{x}11, an expansion
+factor of 0.75, \e{and} a specific game selected.
 
 \C{netslide} \i{Netslide}
 
@@ -421,13 +467,53 @@ generation of Net (see \k{net}) with the movement of Sixteen (see
 into place you have to slide them into place by moving a whole row at
 a time. 
 
-
 As in Sixteen, \I{controls, for Netslide}control is with the mouse.
 See \k{sixteen-controls}.
 
 \I{parameters, for Netslide}Game parameters are the same as for Net
 (see \k{net-params}).
 
+\C{pattern} \i{Pattern}
+
+\cfg{winhelp-topic}{games.pattern}
+
+You have a grid of squares, which must all be filled in either black
+or white. Beside each row of the grid are listed the lengths of the
+runs of black squares on that row; above each column are listed the
+lengths of the runs of black squares in that column. Your aim is to
+fill in the entire grid black or white.
+
+I first saw this puzzle form around 1995, under the name
+\q{nonograms}. I've seen it in various places since then, under
+different names.
+
+Normally, puzzles of this type turn out to be a meaningful picture
+of something once you've solved them. However, since this version
+generates the puzzles automatically, they will just look like random
+groupings of squares. (One user has suggested that this is actually
+a \e{good} thing, since it prevents you from guessing the colour of
+squares based on the picture, and forces you to use logic instead.)
+The advantage, though, is that you never run out of them.
+
+\H{pattern-controls} \i{Pattern controls}
+
+This game is played with the mouse.
+
+Left-click in a square to colour it black. Right-click to colour it
+white. If you make a mistake, you can middle-click, or hold down
+Shift while clicking with any button, to colour the square in the
+default grey (meaning \q{undecided}) again.
+
+You can click and drag with the left or right mouse button to colour
+a vertical or horizontal line of squares black or white at a time
+(respectively). If you click and drag with the middle button, or
+with Shift held down, you can colour a whole rectangle of squares
+grey.
+
+\H{pattern-parameters} \I{parameters, for Pattern}Pattern parameters
+
+The only options available from the \q{Custom...} option on the \q{Type}
+menu are \e{Width} and \e{Height}, which are self-explanatory.
 
 \A{licence} \I{MIT licence}\ii{Licence}