podindex1p

Synopsys

podindex [options] <pod(s)>...

Reads pod(s) and prints an index to stdout. Options:

    --package=PACKAGE   precede the index by a perl package declaration
    --help              this help
    --version           print version number

Overview

This is a simple wrapper script around Pod::Index::Builder. It parses the POD files given as arguments, finds all X<> entries, generates an index and prints it to standard output.

Options

package

If given, it will place the index in the __DATA__ section of a perl package. For example,

    podindex --package=perlindex perlop.pod

outputs something like this:

        package perlindex;
        1;
        __DATA__
        !       perlsyn 116     DESCRIPTION
        !       perlop  207     Symbolic Unary Operators
        !=      perlop  436     Equality Operators
        !~      perlop  242     DESCRIPTION

This is used so that an index can be placed in @INC and found easily (See Pod::Index::Search).