My goal for the forthcoming LinuxCNC release is readiness for inclusion
in both Fedora and Debian.
Right now, a "sample-configs" directory is installed into
${prefix}/share/doc/linuxcnc/examples.
This is a typical pattern, at first glance, but it turns out that the
GUIs actually present these as base configurations to users, and do bad
things when they are not present.
The Fedora Packaging Guidelines are clear that these files must not be
marked as %doc [1]. However, neither source I found for documentation
packaging [1,2] said clearly whether files not marked as %doc are
allowed in %{_defaultdocdir}/%{name}-%{version} (and neither mentions
that fc20 doc dirs seem to be unversioned).
The Debian docs are quite clear that runtime must not depend on anything
in /usr/share/doc [3].
I think it's clear that these files belong in
${sysconfdir}/linuxcnc/examples, but I'd like to hear the community's
opinion on whether this is a hole in the Guidelines, or am I again being
ovenly pedantic.
John
[1] https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation
[2] https://fedoraproject.org/wiki/Packaging_tricks#Examples
[3] https://www.debian.org/doc/debian-policy/ch-docs.html#s12.3
--
devel mailing list
devel@lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/devel
Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
