<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Sun, Feb 9, 2014 at 10:40 AM, John Morris <span dir="ltr"><<a href="mailto:john@zultron.com" target="_blank">john@zultron.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="">On 02/09/2014 02:32 AM, Miloslav Trmač wrote:<br>
> On Sun, Feb 9, 2014 at 9:16 AM, John Morris <<a href="mailto:john@zultron.com">john@zultron.com</a><br>
</div><div><div class="h5">> <mailto:<a href="mailto:john@zultron.com">john@zultron.com</a>>> wrote:<br>
><br>
> Right now, a "sample-configs" directory is installed into<br>
> ${prefix}/share/doc/linuxcnc/examples.<br>
><br>
> This is a typical pattern, at first glance, but it turns out that the<br>
> GUIs actually present these as base configurations to users, and do bad<br>
> things when they are not present.<br>
><br>
> The Fedora Packaging Guidelines are clear that these files must not be<br>
> marked as %doc [1]. However, neither source I found for documentation<br>
> packaging [1,2] said clearly whether files not marked as %doc are<br>
> allowed in %{_defaultdocdir}/%{name}-%{version} (and neither mentions<br>
> that fc20 doc dirs seem to be unversioned).<br>
><br>
><br>
> I think the ultimate arbiter is whether (rpm -Uvh --excludedocs<br>
> $that_package) will install the files or not. --excludedocs is what the<br>
> users are supposed to be using to install without documentation, not (rm<br>
> -rf /usr/share/doc $and_a_dozen_of_other_paths).<br>
<br>
</div></div>I'm having trouble with this. To rephrase your reply, as I understand it:<br>
<br>
The arbiter of whether Fedora Packaging Guidelines allows non-%doc<br>
files to be installed in /usr/share/doc and other locations [like<br>
what?] is whether or not '--excludedocs' will install the files.<br></blockquote><div><br></div><div>Yes: the intent of the guideline is to "make --excludedocs work".<br> <br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I imagine the '--excludedocs' argument does not affect files *not*<br>
marked as %doc, even if installed in /usr/share/doc. Could you mean<br>
that, non-%doc files would be installed there despite '--excludedocs' is<br>
a violation of Guidelines?<br>
<br>
Restating the question [omitted in the reply]: By Fedora Packaging<br>
Guidelines, are runtime-dependent files (*not* marked as %doc, of<br>
course!) allowed in %{_defaultdocdir}/%{name}-%{version}?<br></blockquote><div><br></div><div>"The guidelines are unclear, but --excludedocs is how you determine what they meant to say". </div></div><br></div>
<div class="gmail_extra">Michael has said that anything in /usr/share/doc is implicitly marked as %doc , so that settles that: The files you are asking about can't exist.<br></div><div class="gmail_extra"> Mirek<br>
</div></div>