MULTI(1)		     General Commands Manual			MULTI(1)

NAME
     multi - Multiple word anagramming utility

SYNOPSIS
     multi [letter set] [number of words] [word file]


DESCRIPTION
     multi  finds  multiple word "anagrams" (permissible word permutations) of a
     given letter set.	The underscore (_) represents "wild card" letters, anal-
     ogous to blank tiles in a familiar commercial word construction board game.
     The output is printed to stdout and may of course be redirected.

     Examples:

     multi etaoinshrdlu 2 finds all 2-word anagrams of "etaoinshrdlu" using  the
     default word list, /usr/share/dict/word.list, as the reference list.

     multi  orw_gin  2	finds all 2-word anagrams of "orw (wild card) gin" using
     the default word list, /usr/share/dict/word.list, as the reference list.

     multi abcdefgh 3 /usr/share/dict/linux.words finds all 3-word  anagrams  of
     "abcdefgh" using /usr/share/dict/linux.words as the reference list.

     Note that anagram multiples greater than 3 slow program execution consider-
     ably.


OPTIONS
     None.



FILES
     /usr/share/dict/word.list	The  word  list installed from the yawl package,
     which is the default list used if none other is specified.	  Any  alphabet-
     ized  ASCII  list	in  "standard" form, i.e., one word per line, would also
     work.

     anagram_.xxx Intermediate files created during  program  run,  but	 deleted
     upon termination.




SEE ALSO
     anagram(1)



BUGS
     Runs too slowly. Optimization and fine tuning needed.




AUTHOR
     Mendel Cooper - <thegrendel@theriver.com>

				   Version 0.2				MULTI(1)