Red Hat Bugzilla – Bug 193952
RFE: fix spurious no-documentation warning on -devel subpackages
Last modified: 2007-11-30 17:11:34 EST
For almost each review I do where there is a -devel subpackage I get the
following warning from rpmlint:
W: xxx-devel no-documentation
I would like rpmlint to not emit this warning for -devel subpackages (when
coding this better make that an array of possible subpackages for which to not
emit this, I'm sure once this is in people will think up other subpackages which
usualy don't have docs).
I don't see that warning as spurious, but rather a reminder to check if there
are some docs available that would be good to have included in the devel
subpackage, just like all other packages.
One warning per such a package isn't exactly an amount of noise that would make
it harder to spot other problems, so I'm inclined to leave this as is. If
consensus says this is not good, I'll filter it out, but please initiate public
discussion somewhere (fedora-packaging list?) so the consensus can be heard.
Implementing this would be trivial, it's already done for -debuginfo packages
(which never contain documentation and there's nothing a packager can do about
that, so it's a different case), see /usr/share/rpmlint/config.
I've send a mail about this to f-e-l as I'm not on f-p-l.
Personally I'd like to see more man 3 pages for libraries. Perhaps this warning
should be considered an error?
Now that I'm a few months older and wiser, I think the warning indeed is just
fine as initially indicated by Ville, closing as not a bug.