Non-%doc files in %{_defaultdocdir}?

Rex Dieter rdieter at math.unl.edu
Mon Feb 10 04:15:11 UTC 2014


John Morris wrote:

> 
> 
> On 02/09/2014 05:20 PM, Rex Dieter wrote:
>> 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].
>> 
>> I don't interpret it that way at all.  These are *example* configs,
>> marking
>> them as documentation is perfectly ok.  That is, unless these are
>> actually
>> expected to exist at runtime?  (If so, I'd argue that's a bug in the
>> software).
> 
> Yes, they call them 'sample-configs', but when the user starts the GUI
> the first time, a menu of these sample configs is presented for the user
> to choose from.  If the files are missing, the GUI doesn't find them and
> prints an error and maybe exits, I forget.

OK, then move them elsewhere and/or don't mark them as %doc, indeed.

-- Rex



More information about the devel mailing list