NAME

boggler -- find words in a block of letters, in the manner of Boggle

SYNOPSIS

boggler [-w wordlist] [-q] row [row ...]

DESCRIPTION

boggler finds words in a block of letters, in the manner of the game Boggle from Parker Brothers. A word is spelled out by joining letters up, down, sideways, and diagonally, in a continuous path. The same instance of a letter may not be used more than once in the same word.

boggler will print all words that can be spelled out with the given block of letters. Each row of letters in the block is passed as a separate argument. The standard block is four letters by four letters, but boggler will accept any rectangular block of letters.

OPTIONS

boggler accepts the following options:

-w wordlist
By default, boggler looks for a word file named 'wordlist' in the same directory as the executable. Use the -w option to specify the path to an alternate word list.

-l minlength
The minimum length of allowed words. 'qu' is always counted as two letters, regardless of the -q option. Default for minimum length is 3.

-q
Normally, boggler will assume the letter 'q' in the block of letters represents 'qu'. (The game Boggle has a cube printed 'Qu'.) With the -q option, boggler will treat 'q' as 'q'. Of course, this makes the letter 'q' harder to use in a word.

FILES

wordlist
The list of words, found with the executable.

For a comprehensive word list, the author recommends the ENABLE word list, with more than 172,000 words, which can be found at http://personal.riverusers.com/~thegrendel/software.html

BUGS

boggler has no known bugs.

AUTHOR

boggler was written by Ronald J Kimball, rjk-perl@tamias.net.

COPYRIGHT and LICENSE

This program is copyright 2001 by Ronald J Kimball.

This program is free and open software. You may use, modify, or distribute this program (and any modified variants) in any way you wish, provided you do not restrict others from doing the same.