Packaging guidelines for documentation clairfication needed

[Richard Shaw]

While working through a package review[1] this excerpt from the
documentation section[2] was brought to my attention:

"Marking a *relative* path with %doc in the %files section will cause RPM
to copy the referenced file or directory from %_builddir to the proper
location for documentation. Files can also be placed in %_pkgdocdir, and
the build scripts of the software being packaged may do this automatically
when called in %install. However, mixing these methods is problematic and
may result in duplicated or conflicting files, so use of %doc with
*relative* paths and installation of files directly into %_pkgdocdir in the
same source package is forbidden."

In my case the project is installing html documentation during "make
install". Reading this pedantically, it would appear that would prevent me
from using %doc to install the obligatory COPYING, README, ChangeLog, NEWS,
etc...

This doesn't seem to be very practical and I'm not sure that's what was
intended by the guidelines.

Thoughts?

Thanks,
Richard

[1] https://bugzilla.redhat.com/show_bug.cgi?id=1221781
[2] https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/devel/attachments/20150914/2fc9f9b2/attachment.html>