NAME

Lingua::EN::Infinitive - Determine the infinitive form of a conjugated word

SYNOPSIS

use Lingua::EN::Infinitive;

my($spell) = Lingua::EN::Infinitive -> new();
my($word)  = 'rove';

# Method 1:
my($word1, $word2, $suffix, $rule) = $spell -> stem($word);

# Method 2:
$spell -> stem($word);
my($word1, $word2, $suffix, $rule) =
(
	$spell -> {'word1'},  # A possibility.
	$spell -> {'word2'},  # A possibility, or ''.
	$spell -> {'suffix'},
	$spell -> {'rule'},
);

print "Conjugated: $word. Infinitive: $word1. \n";

DESCRIPTION

Determine the infinitive form of a conjugated word. Also, determine the suffix used to identify which rule to apply to transform the conjugated word into the infinitive form.

Either 1 or 2 possible infinitives are returned. You must check that the first is really an English word. If it is, then it is the result. If it is not valid, then check the second.

Failure to deconjugate is indicated by $word1 eq ''.

In general, you can ignore the 3rd and 4th values returned from stem().

The algorithm is based on McIlroy's article (see below), after first checking for irregular words.

In the hash 'suffix2Rule', you'll see the key 'order'. This specifies the sort order in which to check McIlroy's rules. I've changed his ordering in a number of places.

INSTALLATION

You install Lingua::EN::Infinitive, as you would install any perl module library, by running these commands:

perl Makefile.PL
make
make test
make install

If you want to install a private copy of Lingua::EN::Infinitive in your home directory, then you should try to produce the initial Makefile with something like this command:

perl Makefile.PL LIB=~/perl
	or
perl Makefile.PL LIB=C:/Perl/Site/Lib

If, like me, you don't have permission to write man pages into unix system directories, use:

make pure_install

instead of make install. This option is secreted in the middle of p 414 of the second edition of the dromedary book.

WARNING

Don't make the false assumption that

"$word1$suffix" eq $word
	or
"$word2$suffix" eq $word

REFERENCE

Title:   Development of a Spelling List
Author:  M. Douglas McIlroy
Journal: IEEE Transactions on Communications
Issue:   Vol COM-30, No 1, January 1982

AUTHOR

Lingua::EN::Infinitive was written by Ron Savage <ron@savage.net.au> in 1998.

LICENCE

Australian copyright (c) 1999-2002 Ron Savage.

All Programs of mine are 'OSI Certified Open Source Software';
you can redistribute them and/or modify them under the terms of
The Artistic License, a copy of which is available at:
http://www.opensource.org/licenses/index.html