NAME
    Text::Query::Simple - Match text against simple query expression
    and return relevance value for ranking

SYNOPSIS
        use Text::Query::Simple;
        
        # Constructor
        $query = Text::Query::Simple->new([QSTRING] [OPTIONS]);

        # Methods
        $query->prepare(QSTRING [OPTIONS]);
        $query->match([TARGET] [OPTIONS]);

DESCRIPTION
    This module provides an object that tests a string or list of
    strings against a query expression similar to an AltaVista
    "simple query" and returns a "relevance value." Elements of the
    query expression may be regular expressions or literal text.

    Query expressions are compiled into an internal form when a new
    object is created or the `prepare' method is called; they are
    not recompiled on each match.

    Query expressions consist of words (sequences of non-
    whitespace), regexps or phrases (quoted strings) separated by
    whitespace. Words or phrases prefixed with a `+' must be present
    for the expression to match; words or phrases prefixed with a `-
    ' must be absent for the expression to match.

    A successful match returns a count of the number of times any of
    the words (except ones prefixed with `-') appeared in the text.
    This type of result is useful for ranking documents according to
    relevance.

    A word or phrase may be followed by a number in parentheses; this 
    specifies a weight to be given it.

INSTALLATION
    This module is pure Perl, so you can simply copy it into the 
    appropriate directory.

RESTRICTIONS
    This module requires Perl 5.005 or higher.

AUTHOR
    Eric Bohlman (ebohlman@netcom.com)

CREDITS
    The parse_tokens routine was adapted from the parse_line routine
    in Text::Parsewords.

COPYRIGHT
    Copyright (c) 1998 Eric Bohlman. All rights reserved. This
    program is free software; you can redistribute and/or modify
    it under the same terms as Perl itself.