Pod::Index::Search - Search for keywords in an indexed pod

NAME

Pod::Index::Search - Search for keywords in an indexed pod

SYNOPSIS

    use Pod::Index::Search;

    my $q = Pod::Index::Search->new;

    my @results = $q->search('getprotobyname');

    for my $r (@results) {
        printf "%s\t%s\n", $r->podname, $r->line;
        print $r->pod;
    }

    my @subtopics = $q->subtopics('operator');

This module searches an index created by the Pod::Index::Builder manpage. Search results are returned as the Pod::Index::Entry manpage objects.

It is also possible to search for subtopics for a keyword. For example, a search for ``operator'' might return things like

    operator, conditional
    operator, filetest
    operator, logical
    operator, precedence
    operator, relational

The subtopics returned are simple strings.

new

    my $q = Pod::Index::Search->new(%args);

Create a new search object. Possible arguments are:

The filehandle of the index to use. If omitted, perlindex::DATA is used.

The filename of the index to use. Note that you can specify either fh or filename, but not both.

A subroutine reference that takes a podname and returns a filename. A simple example might be:

    sub {
        my $podname = shift;
        return "/usr/lib/perl5/5.8.7/pod/$podname.pod";
    }

The podname is in colon-delimited Perl package syntax.

If true, the search will be case-insensitive.

Do the actual search in the index. Returns a list of search results, as the Pod::Index::Entry manpage objects.

    my @topics = $q->subtopics('operator');
    my @topics = $q->subtopics('operator', deep => 1);

Lists the subtopics for a given keyword. If deep is given, it includes all subtopics; otherwise, only the first level of subtopics is included.

0.12

Ivan Tubert-Brohman <itub@cpan.org>

Pod::Index::Search - Search for keywords in an indexed pod