On Thu, 03 Nov 2011 09:53:33 +0100, Olivier Sallou wrote: > There are several cases: > - missing description in =head1 NAME > > - dual =head1 NAME, one with description, one with no description. > > It hits more than 200 files.... Hm, this is really a mess. And dropping manpages seems only viable for some of them. But after I had the suspicion that this is not handwritten, I discovered something interesting: maint/bin/update_dbic_dump.pl which seems to create (at least parts of) the modules/POD. Especially generate_chado_submodule_pod and _generate_chado_submodule_podfile look interesting, and there's something about comments that are turned into whatis entries. And they seem to come from %module_descriptions which seems to get filled by some parsing of some (upstream chado) xml file, probably https://gmod.svn.sourceforge.net/svnroot/gmod/schema/trunk/chado/chado-module-metadata.xml Phew. Hm, not sure about the best way to proceed. Either someone digs closer into this script or comesout with a fixit script, or upstream can be bothered to improve the situation ... Cheers, gregor -- .''`. Homepage: http://info.comodo.priv.at/ - OpenPGP key ID: 0x8649AA06 : :' : Debian GNU/Linux user, admin, & developer - http://www.debian.org/ `. `' Member of VIBE!AT & SPI, fellow of Free Software Foundation Europe `- NP: The Dubliners: Johnny McGory
Attachment:
signature.asc
Description: Digital signature