Skip Menu |

This queue is for tickets about the Pod-Parser CPAN distribution.

Report information
The Basics
Id: 15718
Status: resolved
Priority: 0/
Queue: Pod-Parser

People
Owner: Marek.Rouchal [...] gmx.net
Requestors: jonathan [...] pnc.net
Cc:
AdminCc:

Bug Information
Severity: Important
Broken in: 1.34
Fixed in: 1.35



Subject: Documentation: -section argument should be -sections
Pod-Parser-1.34 Pod-Usage-1.33 perl, v5.8.6 built for darwin-thread-multi-2level Darwin Kernel Version 8.3.0 Power Macintosh powerpc Tried using -section option to print just NAME and VERSION sections for use with a --version command line argument to my script: pod2usage(-verbose => 99, -section => 'NAME|VERSION', -exitval=>$status{OK}) if $show_version; Result was the entire POD was printed. I checked the source of Pod::Usage and saw that the name of the argument is really -sections (plural) and not -section (singular). So I tried the same with -sectiosn: pod2usage(-verbose => 99, -sections => 'NAME|VERSION', -exitval=>$status{OK}) if $show_version; And still the entire POD was printed. So the first thing to fix is the documentation, but beyond that if there's not a bug in the code then please provide an example of how to use the -sections argument in the documentation. It shouldn't be so difficult. Thanks
Altough I agree with the documentation issue, the "-sections" option works for me. Here's a proposed patch for the documentations (Pod::Usage v. 1.33 in Pod::Parser 1.34j patch attached too): --- /opt/perl/lib/5.8.8/Pod/Usage.pm 2006-02-02 12:58:49.000000000 +0100 +++ Usage.pm 2006-04-30 13:07:25.067592208 +0200 @@ -96,11 +96,11 @@ "OPTIONS", "ARGUMENTS", or "OPTIONS AND ARGUMENTS" is printed. If the corresponding value is 2 or more then the entire manpage is printed. -The special verbosity level 99 requires to also specify the -section +The special verbosity level 99 requires to also specify the -sections parameter; then these sections are extracted (see L<Pod::Select>) and printed. -=item C<-section> +=item C<-sections> A string representing a selection list for sections to be printed when -verbose is set to 99, e.g. C<"NAME|SYNOPSIS|DESCRIPTION|VERSION">.
Download Pod-Usage-1.33-diff
application/octet-stream 692b

Message body not shown because it is not plain text.