install.pod - how to install WordNet::SenseRelate::TargetWord
perl Makefile.PL make make test make install
You need to have WordNet (version 1.7.1 or later, 2.0 preferred), WordNet::QueryData (version 1.30 or later), WordNet::Similarity (latest version preferred), XML::Parser (version 2.34 or later) installed. Optionally, you should also have Gtk+ (version 1.2.x) and Gtk::Perl installed, to be able to use the graphical interfaces provided.
WordNet is available at http://www.cogsci.princeton.edu/~wn/
WordNet::QueryData is available from http://search.cpan.org/dist/WordNet-QueryData/
WordNet::Similarity is available from http://search.cpan.org/dist/WordNet-Similarity/
XML::Parser is available from http://search.cpan.org/dist/XML-Parser/
Gtk is available from http://www.gtk.org/
Gtk::Perl is available from http://search.cpan.org/dist/Gtk-Perl/
You should set the WNHOME environment variable to the location where you have WordNet installed; see the WordNet::QueryData documentation for more information.
The usual way to install the package is to run the following commands:
perl Makefile.PL make make test make install
If you can't set the WNHOME environment variable, you can use the WNHOME option when running perl Makefile.PL. For example,
perl Makefile.PL WNHOME=/usr/local/WordNet-2.0
You will often need root access/superuser priviledges to run make install. The module can also be installed locally. To do a local install, you need to specify a PREFIX option when you run 'perl Makefile.PL'. For example,
perl Makefile.PL PREFIX=/home/sid
or
perl Makefile.PL LIB=/home/sid/lib PREFIX=/home/sid
will install Similarity into /home/sid. The first method above will install the modules in /home/sid/lib/perl5/site_perl/5.8.3 (assuming you are using version 5.8.3 of Perl; otherwise, the directory will be slightly different). The second method will install the modules in /home/sid/lib. In either case the executable scripts will be installed in /home/sid/bin and the man pages will be installed in /home/sid/share.
In your Perl programs that you may write using the modules, you may need to add a line like so
use lib '/home/sid/lib/perl5/site_perl/5.8.3';
if you used the first method or
use lib '/home/sid/lib';
if you used the second method. By doing this, the installed modules are found by your program. To run the similarity.pl program, you would need to do
perl -I/home/sid/lib/perl5/site_perl/5.8.3 similarity.pl
or
perl -I/home/sid/lib
Of course, you could also add the 'use lib' line to the top of the program yourself. You will need to replace 5.8.3 with whatever version of Perl you are using. The preceeding instructions should be sufficient for standard and slightly non-standard installations. However, if you need to modify other makefile options you should look at the ExtUtils::MakeMaker documentation. Modifying other makefile options is not recommended unless you really, absolutely, and completely know what you're doing!
Alternatively, you could also set the PERL5LIB environment variable to indicate the location of the Perl modules.
NOTE: If one (or more) of the tests run by 'make test' fails, you will see a summary of the tests that failed, followed by a message of the form "make: *** [test_dynamic] Error Y" where Y is a number between 1 and 255 (inclusive). If the number is less than 255, then it indicates how many test failed (if more than 254 tests failed, then 254 will still be shown). If one or more tests died, then 255 will be shown. For more details, see:
http://search.cpan.org/dist/Test-Simple/lib/Test/Builder.pm#EXIT_CODES
Ted Pedersen, University of Minnesota Duluth tpederse at d.umn.edu Siddharth Patwardhan, University of Utah, Salt Lake City sidd at cs.utah.edu Satanjeev Banerjee, Carnegie Mellon University, Pittsburgh banerjee+ at cs.cmu.edu
intro.pod modules.pod
Copyright (C) 2005 Ted Pedersen, Siddharth Patwardhan, and Satanjeev Banerjee
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
Note: a copy of the GNU Free Documentation License is available on the web at http://www.gnu.org/copyleft/fdl.html and is included in this distribution as FDL.txt.
