On Sun, 09 Feb 2014 02:16:43 -0600, John Morris wrote: > 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} Files below /usr/share/doc are always marked as %doc (rpm -E %__docdir_path). If the packaged software strictly depends on files at run-time (and e.g. crashes if they are not found), they must not be packaged as %doc files. > (and neither mentions > that fc20 doc dirs seem to be unversioned). https://fedoraproject.org/wiki/Changes/UnversionedDocdirs The packaging guidelines in the Wiki are not editable by everyone. Somebody from the FPC may need to add a pointer. -- devel mailing list devel@xxxxxxxxxxxxxxxxxxxxxxx https://admin.fedoraproject.org/mailman/listinfo/devel Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct