pdl::pod::select(3) [suse man page]

Select(3)						User Contributed Perl Documentation						 Select(3)

NAME

       podselect - function to extract selected sections of pod documentation

SYNOPSIS

	   use PDL::Pod::Select;
	   podselect (@filelist);
	   podselect ({OUTPUT => "tmp.out"}, @filelist):
	   podselect ({SELECT => ["NAME|SYNOPSIS", "OPTIONS"]}, @filelist):
	   podselect ({OUTPUT => ">&STDERR", SELECT => ["DESCRIPTION"]}, "-");

DESCRIPTION

       podselect() is a function which will extract specified sections of pod documentation from an input stream. This ability is already provided
       in the PDL::Pod::Parser module. Subclasses of PDL::Pod::Parser that wish to take advantage of this feature do not need to derive from
       PDL::Pod::Select. PDL::Pod::Select merely provides a single function named podselect() which provides this capability in function form (as
       opposed to object form) for extracting the raw pod docs.

   podselect(\%options, @filelist)
       podselect will print the raw (untranslated) pod documentation of all pod sections in the given input files specified by @filelist according
       to the given options.

       If any argument to podselect is a reference to a hash (associative array) then the values with the following keys are processed as follows:

       "OUTPUT"
	   A string corresponding to the desired output file (or ">&STDOUT" or ">&STDERR"). The default is to use standard output.

       "SELECT"
	   A reference to an array of sections specifications (as described in "SECTION SPECIFICATIONS" in PDL::Pod::Parser) which indicate the
	   desired set of pod sections and subsections to be selected from input. If no section specifications are given, then all sections of pod
	   documentation are used.

       All other arguments should correspond to the names of input files containing pod documentation. A file name of "-" or "<&STDIN" will be
       interpeted to mean standard input (which is the default if no filenames are given).

SEE ALSO

       PDL::Pod::Parser

AUTHOR

       Brad Appleton <Brad_Appleton-GBDA001@email.mot.com>

       Based on code for pod2text written by Tom Christiansen <tchrist@mox.perl.com>

perl v5.12.1							    2009-10-17								 Select(3)

Check Out this Related Man Page

PODSELECT(1)						User Contributed Perl Documentation					      PODSELECT(1)

NAME

       podselect - print selected sections of pod documentation on standard output

SYNOPSIS

       podselect [-help] [-man] [-section section-spec] [file ...]

OPTIONS AND ARGUMENTS

       -help   Print a brief help message and exit.

       -man    Print the manual page and exit.

       -section section-spec
	       Specify a section to include in the output.  See "SECTION SPECIFICATIONS" in Pod::Parser for the format to use for section-spec.
	       This option may be given multiple times on the command line.

       file    The pathname of a file from which to select sections of pod documentation (defaults to standard input).

DESCRIPTION

       podselect will read the given input files looking for pod documentation and will print out (in raw pod format) all sections that match one
       ore more of the given section specifications. If no section specifications are given than all pod sections encountered are output.

       podselect invokes the podselect() function exported by Pod::Select Please see "podselect()" in Pod::Select for more details.

SEE ALSO

       Pod::Parser and Pod::Select

AUTHOR

       Please report bugs using <http://rt.cpan.org>.

       Brad Appleton <bradapp@enteract.com>

       Based on code for Pod::Text::pod2text(1) written by Tom Christiansen <tchrist@mox.perl.com>

perl v5.16.3							    2014-06-10							      PODSELECT(1)

Linux and UNIX Man Pages

pdl::pod::select(3) [suse man page]

Check Out this Related Man Page