develooper Front page | perl.perl5.porters | Postings from March 2009

Re: [PATCH] Markup in the NAME section is not portable

Thread Previous | Thread Next
Michael G Schwern
March 4, 2009 13:32
Re: [PATCH] Markup in the NAME section is not portable
Message ID:
Niko Tyni wrote:
> As discussed in [ #43078] and Debian bug #304143,
> markup in the NAME section of manual pages is not portable.
> In particular, the whatis parser on Debian cannot handle C<> in whatis
> entries, resulting in garbage like
>  c2ph (1) - Dump C structures as generated from *(C`cc - g - S*(C' stabs
> My tests indicate Solaris 10 and Tru64 5.1 are affected too.

According to that bug, the problem is the bad formatting in the man page which
suggests a bug or impoliteness in Pod::Man and an inadequacy in whatis' roff
parsing.  Stripping C<> from the docs is just treating the symptom.

It seems the patch to make Pod::Man more polite about C<> in NAME in 43078 is

24. Must not tell any officer that I am smarter than they are, especially
    if it's true.
    -- The 213 Things Skippy Is No Longer Allowed To Do In The U.S. Army

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About