Bug 993905

Summary: kernel possibly affected by F-20 unversioned docdir change
Product: [Fedora] Fedora Reporter: Ville Skyttä <ville.skytta>
Component: kernelAssignee: Kernel Maintainer List <kernel-maint>
Status: CLOSED CURRENTRELEASE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: rawhideCC: gansalmon, itamar, jonathan, kernel-maint, madhu.chinakonda
Target Milestone: ---Keywords: Reopened
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
URL: http://fedoraproject.org/wiki/Changes/UnversionedDocdirs
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-09-10 15:53:28 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 993551    

Description Ville Skyttä 2013-08-06 13:05:37 UTC
kernel was identified as a package possibly needing maintainer attention
due to the F-20 unversioned doc dir change. The identification is not
foolproof, it is basically this grep:

    grep -E "(/doc|_docdir|_defaultdocdir).+version" *.spec

Please review your package and make the appropriate changes, if any. A
good starting point is checking the lines output by the above grep for
your specfile. For the vast majority of packages, after the changes,
the expected outcome is that documentation dirs in /usr/share/doc
should no longer contain the package version.

More information and tips:
  https://fedoraproject.org/wiki/Changes/UnversionedDocdirs
  http://thread.gmane.org/gmane.linux.redhat.fedora.devel/183942/focus=183943
  http://thread.gmane.org/gmane.linux.redhat.fedora.devel/183942/focus=183973

Comment 1 Josh Boyer 2013-08-06 15:26:05 UTC
We're not going to change this.  The documentation installed by the kernel is very version specific, and the kernel is one of the few packages in Fedora that can have parallel installed versions.

Comment 2 Ville Skyttä 2013-08-06 15:47:40 UTC
Reopening just to confirm, is the intention for several kernel-doc to be parallel installable as well?

If yes, they currently aren't because the man pages which aren't installed into versioned dirs cause conflicts. Also if yes, yum's configuration should probably be adjusted accordingly (add kernel-doc to installonlypkgs).

Comment 3 Josh Boyer 2013-08-06 16:35:16 UTC
(In reply to Ville Skyttä from comment #2)
> Reopening just to confirm, is the intention for several kernel-doc to be
> parallel installable as well?

Arguably, yes.

> If yes, they currently aren't because the man pages which aren't installed
> into versioned dirs cause conflicts. Also if yes, yum's configuration should
> probably be adjusted accordingly (add kernel-doc to installonlypkgs).

Sigh.  I hate that damn package.

The man pages that are installed are for kernel internals, and therefore still version specific.  They're also essentially a copy of the HTML pages installed in /usr/share/doc/kernel-<version>.  I think we'll just not install the man pages at all.