NAME

       Lingua::EN::Inflect::Phrase - Inflect short English Phrases

SYNOPSIS

         use Lingua::EN::Inflect::Phrase;
         use Test::More tests => 2;

         my $plural   = Lingua::EN::Inflect::Phrase::to_PL('green egg and ham');

         is $plural, 'green eggs and ham';

         my $singular = Lingua::EN::Inflect::Phrase::to_S('green eggs and ham');

         is $singular, 'green egg and ham';

DESCRIPTION

       Attempts to pluralize or singularize short English phrases.

       Does not throw exceptions at present, if you attempt to pluralize an already pluralized
       phrase, it will leave it unchanged (and vice versa.)

       The behavior of this module is subject to change as I tweak the heuristics, as some things
       get fixed others might regress. The processing of natural language is a messy business.

       If it doesn't work, please email or submit to RT the example you tried, and I'll try to
       fix it.

OPTIONS

       By default, this module prefers to treat words as nouns (sometimes words can be
       interpreted as a verb or a noun without context.) This is better for things such as
       database table/column names, which is what this module is primarily for.

       This behavior can be switched with the variable $prefer_nouns. The default is 1.

       For example:

         {
           local $Lingua::EN::Inflect::Phrase::prefer_nouns = 0;
           is Lingua::EN::Inflect::Phrase::to_S('sources split'), 'source splits';
         }
         {
           local $Lingua::EN::Inflect::Phrase::prefer_nouns = 1;
           is Lingua::EN::Inflect::Phrase::to_S('source splits'), 'source split';
         }

OPTIONAL EXPORTS

       "to_PL", "to_S"

SUBROUTINES

   to_PL
       Attempts to pluralizes a phrase unless already plural.

   to_S
       Attempts to singularize a phrase unless already singular.

BUGS

       Please report any bugs or feature requests to "bug-lingua-en-inflect-phrase at
       rt.cpan.org", or through the web interface at
       http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Lingua-EN-Inflect-Phrase
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Lingua-EN-Inflect-Phrase>.  I will be
       notified, and then you'll automatically be notified of progress on your bug as I make
       changes.

SUPPORT

       More information at:

       •   RT: CPAN's request tracker

           http://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-EN-Inflect-Phrase
           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-EN-Inflect-Phrase>

       •   AnnoCPAN: Annotated CPAN documentation

           http://annocpan.org/dist/Lingua-EN-Inflect-Phrase <http://annocpan.org/dist/Lingua-EN-
           Inflect-Phrase>

       •   CPAN Ratings

           http://cpanratings.perl.org/d/Lingua-EN-Inflect-Phrase
           <http://cpanratings.perl.org/d/Lingua-EN-Inflect-Phrase>

       •   Search CPAN

           http://search.cpan.org/dist/Lingua-EN-Inflect-Phrase/
           <http://search.cpan.org/dist/Lingua-EN-Inflect-Phrase/>

REPOSITORY

         git clone git://github.com/rkitover/lingua-en-inflect-phrase.git lingua-en-inflect-phrase

SEE ALSO

       Lingua::EN::Inflect, Lingua::EN::Inflect::Number, Lingua::EN::Tagger

AUTHOR

       Rafael Kitover <rkitover@cpan.org>

LICENSE AND COPYRIGHT

       Copyright (c) 2010 Rafael Kitover (rkitover@cpan.org).

       This program is free software; you can redistribute it and/or modify it under the terms of
       either: the GNU General Public License as published by the Free Software Foundation; or
       the Artistic License.

       See http://dev.perl.org/licenses/ for more information.