\cfg{text-filename}{puzzles.txt}
-\cfg{xhtml-contents-filename}{index.html}
-\cfg{xhtml-leaf-level}{1}
-\cfg{xhtml-contents-depth-0}{1}
-\cfg{xhtml-contents-depth-1}{2}
-\cfg{xhtml-leaf-contains-contents}{true}
+\#
+\cfg{html-contents-filename}{index.html}
+\cfg{html-leaf-level}{1}
+\cfg{html-contents-depth-0}{1}
+\cfg{html-contents-depth-1}{2}
+\cfg{html-leaf-contains-contents}{true}
+
+\cfg{html-single-filename}{index.html}
+\cfg{html-head-end}{<meta name="AppleTitle" content="Puzzles Help">}
+\cfg{html-leaf-level}{0}
\cfg{info-filename}{puzzles.info}
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
also unlock it again, but while it's locked you can't accidentally
turn it.
+\dt \e{Jumble tiles}: \q{J} key
+
+\dd This key turns all tiles that are not locked to random
+orientations.
+
(All the actions described in \k{common-actions} are also available.)
\H{net-params} \I{parameters, for Net}Net parameters
\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}
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{\i{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{controls, for Pattern}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.
+
+(All the actions described in \k{common-actions} are also available.)
+
+\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}
~mdw / sgt / puzzles / blobdiff