Games/Jumble version 0.06
================================
SYNOPSIS

   use Games::Jumble;

   my $jumble = Games::Jumble->new;
   $jumble->num_words(6);
   $jumble->word_length_allow(5,6);
   $jumble->dict('/home/doug/crossword_dict/unixdict.txt');
  
   my @jumble = $jumble->create_jumble; 

   foreach my $word (@jumble) {
      print "$word\n";
   }

   # Solve jumbled word
   my @good_words = $jumble->solve_word('rta');

   if (@good_words) {
      foreach my $good_word (@good_words) {
         print "$good_word\n";
      }
   } else {
      print "No words found\n";
   }

   # Create jumbled word
   my $word = 'camel';
   my $jumbled_word = $jumble->jumble_word($word);

   print "$jumbled_word ($word)\n";


DESCRIPTION

Games::Jumble is used to create and solve Jumble word puzzle.

Currently Games::Jumble will create random five- and six-letter 
jumbled words from a dictionary. Future versions of Games::Jumble will 
allow user to create custom jumbles by using a user defined word file
with words of any length.
Individual words of any length may be jumbled by using the 
jumble_word() method.

Default number of words is 5.
Default dictionary is '/usr/dict/words'.
Dictionary file must contain one word per line.

REQUIREMENTS

Perl version 5.000 or higher. Developed using version 5.6.1 on Linux.

WHERE CAN I GET IT?

www.cpan.org/authors/id/D/DS/DSPARLING

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

None.

DOCUMENTATION

Documentation is included in the module as POD. 
A man file should be created in the installation process.

CHANGES

See the Changes file.

CREDITS

Tim Maher for pointing out some outdated documentation in the Synopsis.

AUTHOR

Douglas S. Sparling <doug@dougsparling.com>

DISCLAIMER

This program is distributed in the hope that it will be 
useful, but without any warranty; without even the implied
warranty of merchantability or fitness for a particular purpose.

SUPPORT

Questions, bug reports, useful code bits, and suggestions for
Games::Jumble should be sent to me at doug@dougsparling.com.

COPYRIGHT AND LICENCE

Copyright (C) 2001-2003 Douglas S. Sparling. All rights reserved.
This program is free software; you can redistribuite it
and/or modify it under the same terms as Perl itself.

