F20 System Wide Change: Unversioned Docdirs

[Miroslav Suchý]

On 07/16/2013 12:28 PM, Jaroslav Reznik wrote:
> == Detailed description ==
> Change the per package documentation directory in /usr/share/doc to
> unversioned, just containing the package's name (previously it contained both
> the package's name and its version). rpmbuild already has support for this, by
> setting the %_docdir_fmt macro to %{name} we cover most of the cases. Other
> cases can be grepped through from package specfiles/patches -- grepping for
> _docdir, _defaultdocdir, usr/share/doc and _datadir.*doc should catch almost
> everything. Packages for which multiple versions are intended to be installed
> need to be changed to install their docs into appropriately versioned subdirs,
> for example explicitly using the previous NAME-VERSION scheme. Some of these
> cases, if unaddressed, will also manifest themselves as build failures due to
> files not found at expected locations.

Why?

This will allow to have foo-9.8.4 installed together with foo-doc-1.0.0. 
In other words, user can have pretty outdated documentation. Or new 
documentation and outdated code.
Do we want that?

-- 
Miroslav Suchy
Red Hat, Software Engineer