Duplicate documentation files / potentially conflicting

[Richard W.M. Jones]

On Wed, Dec 04, 2013 at 02:58:47PM +0100, Michael Schwendt wrote:
> On Wed, 4 Dec 2013 12:08:08 +0000, Richard W.M. Jones wrote:
> 
> > I've read this several times, and
> > 
> >   https://fedoraproject.org/wiki/Changes/UnversionedDocdirs
> > 
> > and I still don't understand what this message means. 
> 
> My message or a specific bugzilla ticket?

Your message.  Let's take this bug at random, linked from the
tracker bug (993551):

https://bugzilla.redhat.com/show_bug.cgi?id=993805

If I'm understanding this correctly, the problem is that the GRASS
spec file will create /usr/share/doc/grass-%{version}/...  files
because of:

http://pkgs.fedoraproject.org/cgit/grass.git/tree/grass.spec#n210

That's definitely an (un)versioned docdirs problem, no doubt.

GRASS uses doxygen.  But it is not noarch, so presumably this package
is not affected?

If it's not affected, could you please link to the specific bug of a
package which is affected.

> > How would this cause subpackage conflicts?
> 
> Have you heard about Doxygen generated documentation causing conflicts?
> Here the problem is expanded into a conflict between the base package
> and the second package that also includes the documentation.
> 
> > What has arch/noarch got to do with anything?
> 
> A noarch subpackage may be built on any build arch different than the
> builder that creates the base package. This triggers bugs (such as the
> Doxygen timestamp/footer bug), because the noarch build's doc files may
> differ from the arch build's doc files.

Won't the subpackage put docs in /usr/share/doc/pkg-subpkg/ ?

> If no noarch subpkg is involved, it [hopefully] boils down to just
> duplicated files.
> 
> > Can you point to an example of a packaging problem?
> 
> Duplicate files are a packaging problem already. Duplicating the entire
> contents of a huge -doc subpackage in the base package is a problem.

So I think what you're saying is that all subpackage docs are (or
should be?) placed in /usr/share/doc/pkg/ ignoring the subpackage
name?  That is *not* my understanding of how unversioned docdirs works.

> Worse if there is a conflict. The bug reports don't claim there is a
> conflict _always_. But we encounter Doxygen related conflicts regularly,
> even during review.

Rich.

-- 
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
libguestfs lets you edit virtual machines.  Supports shell scripting,
bindings from many languages.  http://libguestfs.org