t/pod/podselect.xr

   1 ###### begin =include podselect.PL #####
   2 NAME
   3     podselect - print selected sections of pod documentation on standard
   4     output
   5
   6 SYNOPSIS
   7     podselect [-help] [-man] [-section *section-spec*] [*file* ...]
   8
   9 OPTIONS AND ARGUMENTS
  10     -help   Print a brief help message and exit.
  11
  12     -man    Print the manual page and exit.
  13
  14     -section *section-spec*
  15             Specify a section to include in the output. See "SECTION
  16             SPECIFICATIONS" in Pod::Parser for the format to use for
  17             *section-spec*. This option may be given multiple times on the
  18             command line.
  19
  20     *file*  The pathname of a file from which to select sections of pod
  21             documentation (defaults to standard input).
  22
  23 DESCRIPTION
  24     podselect will read the given input files looking for pod documentation
  25     and will print out (in raw pod format) all sections that match one ore
  26     more of the given section specifications. If no section specifications
  27     are given than all pod sections encountered are output.
  28
  29     podselect invokes the podselect() function exported by Pod::Select
  30     Please see "podselect()" in Pod::Select for more details.
  31
  32 SEE ALSO
  33     Pod::Parser and Pod::Select
  34
  35 AUTHOR
  36     Brad Appleton <bradapp@enteract.com>
  37
  38     Based on code for Pod::Text::pod2text(1) written by Tom Christiansen
  39     <tchrist@mox.perl.com>
  40
  41 ###### end =include podselect.PL #####