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?