|
-----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. I talked with upstream author. About missing descriptions, he has no idea on content. Perl files with no description are a wrapper above a database schema, but author does not know what those tables are used for (upstream of the schema has not documented those either). So, if possible, I'd like to go for above proposal (upload with 1 bug above what-is missing data) > > 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/ iQIcBAEBCAAGBQJOtAdXAAoJEHjcaNsybYQ4BeQP/2vwFNwQQ+Ohf1aKX9MG3E6R v5NaQ/YBNRQ72rE9s15o5xg7CTa1PRYy94eFwSfW8GGtjeWyAu4enHiP4u9JMWqf E1/YaKw7G3OH4fMYJdE4hJZscsZ5vOmrJYNogSJ833qIJrn0Bm0lX2zle5VhKmWn ViLTiFx0Adf8ZuxtmFGYzS2qQlZgvbo2JcU8nwJE9hvTpbg4UgqoX3p/ew3AzIst 3v4gveHbfNhB05S868j1O/r2JcwyCepfyR5xIwwp7TKvSv5jMgHK/4NbZC4J58qC FM3iOd13wqOkH3w0NTsnBmuhU2aRIJjC6/N+u3DnNza+Ywtdq5BH2skYi/iKTb/i FmetqRqGXoWhxKVfi1HiZgcx6oDYhvwk8ZG/jtCa7zu0od8mNPzRSOnU1tIK2gtE CaMMzPmDtUlm+E0UaPz1IRmSYGdss8BYhYkpd4s5nKJVML+COUrihSq9Pp0/xwAJ WVax+08OXgwuKiG1jAALEl5ZIUsSXYNiP463XQueNi9fvS7aFcXuEMxBBCZQrTxa srSnqieMDSZJNAgNXZqHeJK3KlCbSD5kxvMY+CqILOlcDTmZ15HJpPrH4CG0bgLE dbP2c+XCCal8U1n0xERzJenMcKQBeB9YYjI6D4pB3x1Jh46XiStatKGbrWrZqBSK BfX7kIP9jSMkeZDWCZcL =NKtO -----END PGP SIGNATURE----- |