Bug#962601: manpage-section-mismatch doesn't take into account manpages with multiple binaries
Sergio Durigan Junior <sergiodj@debian.org> writes:
> So, I think I found the problem, and I have a possible solution.
> Apparently, some manpages have malformed .TH headers, and Perl's
> Text::ParseWords::parse_line doesn't cope well with them. For example,
> kde-dev-scripts's /usr/share/man/ca/man1/create_makefiles.1.gz file has:
> .TH "\FBCREATE_MAKEFILES\" "1" "8 de mar\(,c del 2003" "[FIXME: source]" "[FIXME: manual]"
For the record, groff is also unhappy with that line because of the
backslash before the " after CREATE_MAKEFILES. I'm a bit surprised that
it doesn't produce a warning, but it renders the name as
CREATE_MAKEFILES() (note the lack of section number) and gives up on
trying to display the other parts of the .TH macro.
That man page deserves some sort of Lintian tag, since the .TH line isn't
really valid. It would be ideal if the tag were specific to the
underlying problem, but I would consider it reasonable to complain that
one cannot extract the section from that .TH line since groff cannot
either.
--
Russ Allbery (rra@debian.org) <https://www.eyrie.org/~eagle/>
Reply to: