|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 Le 11/3/11 6:02 PM, Olivier Sallou a écrit : > > > > Le 11/3/11 5:58 PM, gregor herrmann a écrit : > > 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 ... > > I gonna ask upstream author about this, maybe he could fix this.... Author has fixed the dual "=head1 NAME" in pod files, this reduce the number of problems. However, description in "=head1 NAME" is still missing in many files, example: =head1 NAME Bio::Chado::Schema::Result::CellLine::CellLineCvtermprop This still impacts LOTS of files. Would you consider uploading the package with this issue, as it is a lintian Warning ? (not now, package is not yet ready) I could create a bug to trace the issue. Olivier > > > Cheers, > > gregor > > > > - -- Olivier Sallou IRISA / University of Rennes 1 Campus de Beaulieu, 35000 RENNES - FRANCE Tel: 02.99.84.71.95 gpg key id: 4096R/326D8438 (pgp.mit.edu) Key fingerprint = 5FB4 6F83 D3B9 5204 6335 D26D 78DC 68DB 326D 8438 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQIbBAEBCAAGBQJOs6QYAAoJEHjcaNsybYQ4+QcP93Q/NxDGstWAOz+JU5y1bcFQ 95aTwCvDwmcol7zhu/S+no2TKXQZ5qVXMeH/Nt22fp10K5PLhl4d5RfchQJIXgcw 901/TZjlkTGfdvsQAkzMMC2LoYeiiUTqersewjAazD7AFdzAY5GtCE2xxQgSG7i8 BHbXPWcIrmDSBPJljYdSp3OkSo0R25LxBUEAsCW0RZgcm76z7NfSFP6MYDqoZT3q RN2gNlt1g5GF/tMESnLo4p1hSnJM9btvyKPwJrN3YOkJlC3JMJnPmMoLB03CwUpu RjIfJcX3FXQ+SWlDf+JoM4hLwsOEIGEnbCKgFdoybkb2Pks18EtQIe0mJCe3AkuG voiS1VWzgjXGSIvo/Sv0Id+50xD4Ed6e5j1/wWpgi+xVmq+yIfEwh31wa9Ww6jIM TtxKvAT7dfXb7I0R5L3kzidsZD9i5teq3R4I+47+oUnwBW8qqswQQPK5Opgfgvug QBwPwIfLHlMJf+rum5UX1g8T+XnmO630JUOXmH8KKh3h280W3ww+LysMPMhjYjot kgqnmvXhRj8J9ALQSnNl8qPluXGdwsl3bt8+TGaOGR+0p4dS+NcSR0UbjmQfktVF O/V900TGu8nbTy/i+Xd3NIqQ3dPWq5epuz1KwY2TO2L/q2lxbOLPMiPqexiah1GR 0fV4aBNWnu+qj1iQXjk= =fIBp -----END PGP SIGNATURE----- |