NAME

wordpuzzle.pl - Script using WordFind.pm to generate puzzles

SYNOPSIS

    wordfind.pl [-lwsi] [-o outfile] [-c columns] wordlist
    wordfind.pl [-dsi] [-c columns] wordlist >outfile

DESCRIPTION

This script uses the WordFind.pm module to create simple puzzles by embedding each word (forwards, backwards, up, down, or diagonally) from the wordlist into a lattice of random letters.

OPTIONS

-c <columns>

This option takes an integer for the size of the puzzle. The default is a 10x10 lattice, using -c 12 would create a 12x12 puzzle. If you enter words longer than <columns>, a warning is issued from WordFind.pm and the word is dropped from the list.

-o <outfile>

Takes a string as the name of an output file. If in latex mode and no .tex extension is given, one is silently added.

-l

Latex mode: return a puzzle in latex tabular format. The puzzle generated has \huge letters for easier viewing for kids.

-w

This puts a complete latex wrapper around the latex puzzle so that the result is directly compilable by latex.

-d

DVI mode: implies -l and -w. Automatically runs latex on the output file to produce a .dvi file, and removes the output file and other intermediary files. If no output file is specified, a default puzzle.tex is used and the resulting dvi file will be puzzle.dvi.

-s

By default, the solution matrix is not returned. Using this option, the returned puzzle will include the solution matrix. In latex mode, the solution will come after a latex \newpage command and be set in its own tabular environment.

-i

By default, no two words can intersect (share letters) in the puzzle. If -i is used, intersecting words will be allowed in the puzzle (but not guaranteed of course).

AUTHOR

Andrew L Johnson <ajohnson@gpu.srv.ualberta.ca>

SEE ALSO

Please also refer to the embedded documentation in the WordFind.pm module.