Sean M Burke <[EMAIL PROTECTED]> writes: > Apparently a complaint about Pod::Man's output, and/or some > man-to-docbook program, and/or a man -k implementation.
>> Problems with DynaLoader.3pm: >> 1. There are multiple name lines. This makes it impossible to translate >> the page to DocBook. It may also confuse some implementations >> of man -k. This is an issue with the source POD file for the DynaLoader documentation. It has multiple lines in the =head1 NAME section. Not much any of the infrastructure can do about this. >> Problems with Getopt::Std.3pm: >> 1. There are multiple name lines. This makes it impossible to translate >> the page to DocBook. It may also confuse some implementations >> of man -k. Same. >> Problems with perlce.1: >> 1. Missing or garbled name section. The most common form of garbling >> is a missing - or extra -. Or your manual page may have been generated >> by a tool that doesn't emit a NAME section as it should. These >> problems make it impossible to lift the page to DocBook. They >> can also confuse some implementations of man -k. perlce doesn't have a properly formatted =head1 NAME section. This should probably just be forwarded to perl5-porters, as none of these are tool problems, just problems with the source POD files. -- Russ Allbery ([EMAIL PROTECTED]) <http://www.eyrie.org/~eagle/>
