Pod::Index::Entry - Represents Pod search result

NAME

Pod::Index::Entry - Represents Pod search result

SYNOPSIS

    use Pod::Index::Entry;
    my $entry =  Pod::Index::Entry->new(
        keyword  => 'constructors',
        podname  => 'perlobj',
        line     => 42,
        filename => '/usr/lib/perl5/5.8.7/pod/perlobj.pod',
        context  => 'Using POD',
    );
    # trivial accessors
    my $podname  = $entry->podname;
    my $filename = $entry->filename;
    my $line     = $entry->line;
    my $context  = $entry->context;
    my $keyword  = $entry->keyword;
    # extract the POD for this entry
    my $pod      = $entry->pod;

DESCRIPTION

This class represents a POD index entry. An entry is defined by the podname/filename, line number, and context. The entry object also has the ability to extract the POD ``scope'' from the filename.

METHODS

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

Create a new search object. Possible arguments are:

podname
The name of the pod, such as .

filename
The filename for the pod, such as Data/Dumper.pm.

line
The line number where the scope of this entry begins.

context
The title of the section that contains this entry.

podname
filename
line
context
These are just simple accessors that return the value of these properties, as given to the constructor.

pod
Extracts the POD for the scope of the entry from $self->filename, beginning at $self->line. For a definition of scope, see the Pod::Index manpage. The POD extraction is delegated to the the Pod::Index::Extract manpage module.

VERSION

0.12

SEE ALSO

the Pod::Index manpage, the Pod::Index::Search manpage, the Pod::Index::Extract manpage

AUTHOR

Ivan Tubert-Brohman <itub@cpan.org>

COPYRIGHT

Copyright (c) 2005 Ivan Tubert-Brohman. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

 Pod::Index::Entry - Represents Pod search result