Skip Menu |

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

Maintainer(s)' notes

Please use Github for all future tickets, patches and pull requests: https://github.com/Dual-Life/Pod-Usage

Thanks to Nicolas R (ATOOMIC) for setting up everything there!

Report information
The Basics
Id: 133242
Status: resolved
Priority: 0/
Queue: Pod-Usage

People
Owner: Nobody in particular
Requestors: ernstki [...] mail.uc.edu
Cc:
AdminCc:

Bug Information
Severity: Unimportant
Broken in: (no value)
Fixed in: (no value)



Subject: Update POD to reflect that -verbose => 0 shows SYNOPSIS|USAGE (patch attached)
Hi Marek, It seems that POD sections entitled "SYNOPSIS" *or* "USAGE" are included with 'pod2usage(-verbose => 0)', yet there is no mention of "USAGE" in the documentation. The included patch (apply with 'patch -p1') makes the necessary correction to the Pod::Usage POD. This is my first patch to any CPAN library, so I am open to coaching or any constructive criticism. Cheers, Kevin
Subject: synopsis_and_or_usage.patch
diff -ru Pod-Usage-1.70.orig/lib/Pod/Usage.pm Pod-Usage-1.70/lib/Pod/Usage.pm --- Pod-Usage-1.70.orig/lib/Pod/Usage.pm 2020-03-15 14:36:26.000000000 -0400 +++ Pod-Usage-1.70/lib/Pod/Usage.pm 2020-08-28 09:06:13.875169818 -0400 @@ -468,13 +468,13 @@ =item C<-verbose> I<value> The desired level of "verboseness" to use when printing the usage message. -If the value is 0, then only the "SYNOPSIS" section of the pod documentation -is printed. If the value is 1, then the "SYNOPSIS" section, along with any -section entitled "OPTIONS", "ARGUMENTS", or "OPTIONS AND ARGUMENTS" is -printed. If the corresponding value is 2 or more then the entire manpage is -printed, using L<perldoc> if available; otherwise L<Pod::Text> is used for -the formatting. For better readability, the all-capital headings are -downcased, e.g. C<SYNOPSIS> =E<gt> C<Synopsis>. +If the value is 0, then only the "SYNOPSIS" and/or "USAGE" sections of the +pod documentation are printed. If the value is 1, then the "SYNOPSIS" and/or +"USAGE" sections, along with any section entitled "OPTIONS", "ARGUMENTS", or +"OPTIONS AND ARGUMENTS" is printed. If the corresponding value is 2 or more +then the entire manpage is printed, using L<perldoc> if available; otherwise +L<Pod::Text> is used for the formatting. For better readability, the +all-capital headings are downcased, e.g. C<SYNOPSIS> =E<gt> C<Synopsis>. The special verbosity level 99 requires to also specify the -sections parameter; then these sections are extracted and printed.