$Id: readme,v 1.3 1997/02/24 23:40:13 fraser Exp $
$Log: readme,v $
Revision 1.3  1997/02/24 23:40:13  fraser
Minor updates before upload

Revision 1.2  1996/09/16 14:57:56  fraser
added bug instructions

# Revision 1.1  1996/09/12  14:24:01  fraser
# Initial revision
#

Multiple-word anagram search program.

Unpack all files into an empty directory, edit Makefile to reflect your
system. In particular, you will need access to a word file for use as a
dictionary. On SunOS and Solaris or Digital Unix, a suitable file is
/usr/dict/words. For other systems, you will need any human-readable text
file containing unique words separated by whitespace (space, newline,
carriage-return or tab-stop) or common punctuation.  Multiple whitespace
is perfectly acceptable, just wasteful. Word files with duplicates are
also acceptable, but are also wasteful. See the manual page for how to
use this program to build unique word lists from ordinary text files.

Output from the first example in the manual page using the SunOS wordfile
is supplied in the file "sample_output"; this should allow you to check
the "thoroughness" of any wordlist you have generated.

Whichever word file you use, you must define it in Makefile. Should you
have no initial file, define it as anything, and always give the ++ switch
to agm until you have generated a default central wordfile, then recompile
agm with this file defined.

Run your choice of:

	make		make executable 'agm' in current directory
	make install	make 'agm' and install in BINDIR
	make clean	remove all but distribution files

Has been successfully compiled (using the vendor's C compiler) and run on:
	SunOS 4.1.x
	Solaris 2.3, 2.4, 2.5.1
	HP-UX A.09.04 (no '-c' CPU limit switch)
	SCO 3.2 (no '-c' or '-t' time switch)
	Digital UNIX (was OSF/1) 3.2

Should work anywhere with the GNU C compiler, this has been verified on:
	Linux 1.2.1, 2.0
	Solaris 2.4

If you find you have to change anything to get it to compile, please
let me know.

For quick reference usage and options, type 'agm'.

Bug reports to the address below. It would be helpful if you included the
output of the program, as well as the output of the command 'agm -v',
together with details of what hardware and OS release you are using.

		Fraser McCrossan

			fraser@aracnet.net
			http://www.aracnet.net/~fraser/anagrams.html
