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: 102117
Status: resolved
Worked: 30 min
Priority: 0/
Queue: Pod-Usage

People
Owner: Marek.Rouchal [...] gmx.net
Requestors: karl [...] freefriends.org
Cc:
AdminCc:

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



Subject: pod2usage() changes formatting
Date: Sat, 14 Feb 2015 00:18:27 GMT
To: bug-Pod-Usage [...] rt.cpan.org
From: karl [...] freefriends.org (Karl Berry)
Here's my third and last (known for now :) and simplest report regarding pod2usage(). Test program: -------------------------------------------------- #!/usr/bin/env perl use Pod::Usage; pod2usage(-exitstatus => 0, -verbose => 0); 1; __END__ =head1 SYNOPSIS trypodi - pod sections usage test -------------------------------------------------- gives me this unexpected output, with the =head1 title being ucfirst-ed and a colon added. -------------------------------------------------- Synopsis: trypodi - pod sections usage test -------------------------------------------------- I expected SYNOPSIS trypodi - pod sections usage test since I see nothing in the doc about altering the formatting of the section titles. Maybe I just missed it. I get the same ucfirst:ed result with -verbose => 1 and -verbose => 99. With -verbose => 2, I get the expected all-caps result. This was on i686-linux with perl 5.20.1, compiled (with gcc 4.9.2) and installed from the original source; Pod/Usage.pm has $VERSION='1.63'. I tried a variety of older Perl versions, both distro-supplied and my compilations, with the same results (or, if old enough, -sections is not supported). Of course I'm happy to supply more information or help debug in any way I can, etc. Thanks for all your work. Karl (karl@freefriends.org)
This is coded explicitly like this in Usage.pm, and the comment there says: # Try to do some lowercasing instead of all-caps in headings, and use # a colon to end all headings. I think was is a deliberate decision to display it that way when using Pod::Text for formatting the output. It wasn't documented in POD though and that will be corrected. -Marek Am Fr 13. Feb 2015, 19:18:37, karl@freefriends.org schrieb: Show quoted text
> Here's my third and last (known for now :) and simplest report regarding > pod2usage(). Test program: > > -------------------------------------------------- > #!/usr/bin/env perl > use Pod::Usage; > pod2usage(-exitstatus => 0, -verbose => 0); > 1; > __END__ > =head1 SYNOPSIS > > trypodi - pod sections usage test > -------------------------------------------------- > > gives me this unexpected output, with the =head1 title being ucfirst-ed > and a colon added. > > -------------------------------------------------- > Synopsis: > trypodi - pod sections usage test > -------------------------------------------------- > > I expected > SYNOPSIS > trypodi - pod sections usage test > > since I see nothing in the doc about altering the formatting of the > section titles. Maybe I just missed it. > > I get the same ucfirst:ed result with -verbose => 1 and -verbose => 99. > With -verbose => 2, I get the expected all-caps result. > > This was on i686-linux with perl 5.20.1, compiled (with gcc 4.9.2) and > installed from the original source; Pod/Usage.pm has $VERSION='1.63'. > I tried a variety of older Perl versions, both distro-supplied and my > compilations, with the same results (or, if old enough, -sections is not > supported). > > Of course I'm happy to supply more information or help debug in any way > I can, etc. Thanks for all your work. > > Karl (karl@freefriends.org)
Subject: Re: [rt.cpan.org #102117] pod2usage() changes formatting
Date: Sun, 15 Feb 2015 23:08:45 GMT
To: bug-Pod-Usage [...] rt.cpan.org
From: karl [...] freefriends.org (Karl Berry)
# Try to do some lowercasing instead of all-caps in headings, and use # a colon to end all headings. Ok, although it seems bizarre to me for Perl to be randomly tinkering with the user's formatting. But I won't argue for a change in behavior. thanks, k
Fixed by documentation update: Pod-Usage-1.66