xref: /original-bsd/games/boggle/boggle/helpfile (revision 3705696b)
1
2Commands:
3
4Enter word:                 <return> or <linefeed> or <space>
5Delete previous character:  <delete> or <backspace>
6Delete line:                <^u> or <^w>
7Redraw screen:              <^l> or <^r>
8Pause game:                 <^s>
9Resume game:                <^q> or <^s>
10Suspend game (BSD only):    <^z>
11Give up on current cube:    <^d>
12Show remaining time:        <space> first thing on a line
13Show help:                  ? (Suspends timer until done)
14Exit game:                  <^c>
15
16(^u means "control u", etc.)
17
18[Note for users of versions of this program that do not display a timer:
19The first word entered after the timer has run out causes a list of all the
20words you found, the words you missed, and your running statistics to be
21displayed.]
22
23Any time you are prompted while the board is displayed you can type:
24                           <esc>word
25to see where "word" is on the board.
26
27Usage:
28    bog [-b] [-d] [-s#] [-t#] [-w#] [+[+]] [boardspec]
29
30    -b: batch mode (boardspec must be present); dictionary read from stdin
31    -d: debug mode
32    -s#: use # as the random number seed
33    -t#: time limit is # seconds instead of default 180
34    -w#: minimum word length is # letters instead of default 3
35    +: can reuse a cube, but not twice in succession
36    ++: can reuse cubes arbitrarily
37    boardspec: the first board to use (use 'q' for 'qu'); e.g.:
38          bog nolezeebnqieegei
39.
40                            Default Rules
41
42A Boggle board is a four by four arrangement of Boggle cubes.
43You have 3 minutes to find as many words as possible in the Boggle board.
44Words are formed by finding a sequence of cubes (letters) that are in the
45game's dictionary.  The (N+1)th cube in the word must be horizontally,
46vertically, or diagonally adjacent to the Nth cube.  Cubes cannot be reused.
47Words consist solely of lower case letters and must be at least 3 letters long.
48.
49                           Options
50
51Command line flags can be given to change the rules of the game.
52The '+' flag allows a cube to be used multiple times, but not in succession.
53The '++' flag makes each cube adjacent to itself.
54The time limit can be changed from the default 3 minutes by using the flag
55'-t#', where # is the duration (in seconds) of each game.
56The minimum word length can be changed from 3 letters by specifying 'w#',
57where # is the minimum number of letters to use.
58.
59                           Bugs and Limitations
60
61The following bugs and problems are known to exist:
62
63- If there are a great many words in the cube the final display of the words
64  may scroll off of the screen.  (On a 25 line screen about 130 words can be
65  displayed.)
66
67- Computing the complete word list can be too slow on small machines.
68
69- No word can contain a 'q' that is not immediately followed by a 'u'.
70
71- When using the '+' or '++' options the display of words found in the board
72  doesn't indicate reused cubes.
73.
74                           About This Program
75
76Permission is given to freely copy and distribute this software providing:
77
781) You do not sell it,
792) You do not use it for commercial advantage,
803) If you pass the program on you must make the source code available, and
814) This notice must accompany the distribution
82
83Please notify the author of any bugs or if you have any suggestions.
84
85Copyright (c) 1988
86Barry Brachman           | UUCP:    {alberta,uw-beaver,uunet}!
87Dept. of Computer Science|           ubc-vision!ubc-csgrads!brachman
88Univ. of British Columbia| Internet: brachman@cs.ubc.ca
89Vancouver, B.C. V6T 1W5  |           brachman%ubc.csnet@csnet-relay.arpa
90(604) 228-5010           | brachman@ubc.csnet
91
92Boggle is a trademark of Parker Brothers.
93