X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FPod%2FSelect.pm;h=8310ea6c7c805bffb7bef18e8ae1456456c6fd1f;hb=53bf329c4a7cae809d0c4c820f4ecdeb18754f17;hp=b933cc2cdf9043585ba12fe31c57e5c952c9dc88;hpb=664bb207f6bd57f05b66c9abec00898987f7060b;p=p5sagit%2Fp5-mst-13.2.git diff --git a/lib/Pod/Select.pm b/lib/Pod/Select.pm index b933cc2..8310ea6 100644 --- a/lib/Pod/Select.pm +++ b/lib/Pod/Select.pm @@ -1,7 +1,7 @@ ############################################################################# # Pod/Select.pm -- function to select portions of POD docs # -# Copyright (C) 1996-1999 by Bradford Appleton. All rights reserved. +# Copyright (C) 1996-2000 by Bradford Appleton. All rights reserved. # This file is part of "PodParser". PodParser is free software; # you can redistribute it and/or modify it under the same terms # as Perl itself. @@ -10,8 +10,8 @@ package Pod::Select; use vars qw($VERSION); -$VERSION = 1.085; ## Current version of this package -require 5.004; ## requires this Perl version or later +$VERSION = 1.13; ## Current version of this package +require 5.005; ## requires this Perl version or later ############################################################################# @@ -62,7 +62,7 @@ or =head1 REQUIRES -perl5.004, Pod::Parser, Exporter, FileHandle, Carp +perl5.005, Pod::Parser, Exporter, Carp =head1 EXPORTS @@ -92,7 +92,7 @@ The formal syntax of a section specification is: =over 4 -=item +=item * I/I/... @@ -109,33 +109,39 @@ Some example section specifications follow. =over 4 -=item +=item * + Match the C and C sections and all of their subsections: C -=item +=item * + Match only the C and C subsections of the C section: C -=item +=item * + Match the C subsection of I sections: C -=item +=item * + Match all subsections of C I for C: C -=item +=item * + Match the C section but do I match any of its subsections: C -=item +=item * + Match all top level sections but none of their subsections: C @@ -160,7 +166,7 @@ The formal syntax of a range specification is: =over 4 -=item +=item * /I/[../I/] @@ -175,7 +181,7 @@ Where I is intended to match the name of one or more POD commands, and I is intended to match the paragraph text for the command. If a range-regex is supposed to match a POD command, then the first character of the regex (the one after the initial '/') -absolutely I be an single '=' character; it may not be anything +absolutely I be a single '=' character; it may not be anything else (not even a regex meta-character) if it is supposed to match against the name of a POD command.