Please do not reply directly to this email. All additional comments should be made in the comments box of this bug.
https://bugzilla.redhat.com/show_bug.cgi?id=725905
Kalev Lember kalevlember@gmail.com changed:
What |Removed |Added ---------------------------------------------------------------------------- Flag|needinfo?(kalevlember@gmail | |.com) |
--- Comment #12 from Kalev Lember kalevlember@gmail.com 2011-08-17 09:47:52 EDT --- (In reply to comment #11)
There is a problem that the -devel subpackage puts doc files in /usr/share/gtk-doc/html but this directory is not owned by anything that is required by p11-kit-devel.
That directory is owned by the p11-kit-devel package itself to avoid a runtime dependency on the gtk-doc package: $ rpm -qlp p11-kit-devel-0.3-1.fc15.x86_64.rpm | grep gtk-doc /usr/share/gtk-doc /usr/share/gtk-doc/html /usr/share/gtk-doc/html/p11-kit /usr/share/gtk-doc/html/p11-kit/api-index-full.html /usr/share/gtk-doc/html/p11-kit/config-format.html ...
See the section in the packaging guidelines on File and Directory Ownership [1] that specifically explains how to deal with gtk-doc directory ownership: https://fedoraproject.org/wiki/Packaging/Guidelines#The_directory_is_owned_b...
Also parts of the documentation document the configuration file format and that should be perhaps documented somehow in the main package, or even some kind of example config files included in the main package.
I don't really want to put large html documentation in the main package. p11-kit is probably going to be included in the live CD and it's nice to keep the size down. However, instead of having the docs in the -devel package, it would be easy to split them out to a separate -doc package. In the future, when upstream has some example config files, we could also put these in the -doc subpackage. Would that be better than shipping all the docs in -devel?