Niko Tyni wrote: > As discussed in [rt.cpan.org #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. > > http://rt.cpan.org/Public/Bug/Display.html?id=43078 > http://bugs.debian.org/304143 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 sufficient. -- 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 http://skippyslist.com/list/Thread Previous | Thread Next