Harvey/Word version 1.01
=======================

The Word.pm module is the first module of the Harvey series
which will be a suite of modules for parsing English
sentences and generating sentences.

The Word.pm module takes a word as an argument and makes a
word object which can be queried for characteristics about
the word, see the documentation in the module itself for
details.

Usage:
 use Harvey::Word;

 my $W = Word->new("table");

 print "It's a noun!\n" if ($W->noun());

The Word.pm module requires the word.db TIE file to be
present in the working directory.  The word.db file can be
exported to an ASCII file named word.txt using the 'export_word'
function in the module.  An 'import_word' function exists for
the opposite operation.

NOTE: The word.pm module depends on the word.db database.  Once
the word.pm module is installed, move the word.db database to
your development directory.  If you would like to set up a special
data directory, modify the following line of the 'tie_hash'
routine as follows:

 tie %t_word,'MLDBM',"(YOUR PATH)word.db", O_CREAT|O_RDWR,0666;

My heartfelt thanks to Adam Kilgarriff for his work on the BNC
(British National Corpus) which forms the basis for the word.db.
I have added and massaged it a bit, but I would never have gotten
this far without it.  The BNC can be visited at
http://www.itri.brighton.ac.uc/~Adam.Kilgarriff/bnc-readme.html.

INSTALLATION

To install this module type the following:

  perl Makefile.PL
  make
  make test
  make install

DEPENDENCIES

This module requires these other modules and libraries:

Storable-1.0.14
Data-Dumper-2.101
DB_File-1.801
MLDBM-2.00

Requires the word.db file which is TIED to the module.

COPYRIGHT AND LICENCE

Copyright (C) 2002 Chris Meyer.  All rights reserved.  This is
free software and may be distributed under the same Terms as Perl
itself.

CONTACT

Chris Meyer, [email protected] and www.mytechs.com.