develooper Front page | perl.pod-people | Postings from April 2012

Re: Strange perldoc perldoc

Thread Previous | Thread Next
From:
Russ Allbery
Date:
April 30, 2012 10:30
Subject:
Re: Strange perldoc perldoc
Message ID:
877gwx9lg5.fsf@windlord.stanford.edu
Shawn H Corey <shawnhcorey@gmail.com> writes:
> On 12-04-30 12:33 PM, Russ Allbery wrote:

>> Which pod2foo are you running that made that verbatim?  Neither
>> pod2text nor pod2man from podlators as distributed on CPAN do.

> I just type: perldoc perldoc

That uses Pod::Man by default, at least on UNIX.  When I run that command
with Perl 5.14.2, I get what I would expect; no indentation, and proper
formatting.

I think we need more information about what's different on your system.

I can say for certain that there's no special handling of SYNOPSIS in
either Pod::Man or Pod::Text.

> Also, neither http://perldoc.perl.org/perlpod.html or
> http://perldoc.perl.org/perlpodspec.html says SYNOPSIS have special
> treatment.

Indeed, and it shouldn't have any special treatment.  You're experiencing
some sort of bug, I think.  I just don't know where.

-- 
Russ Allbery (rra@stanford.edu)             <http://www.eyrie.org/~eagle/>

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About