Red Hat Bugzilla – Bug 152527
RHEL5-rg-bug: kernel-doc package not included in comps.xml
Last modified: 2010-08-25 19:08:00 EDT
Description of problem:
kernel-doc package is not selectable (or otherwise selected) at install time as
part of any group and there is no reference to it in comps.xml however the
package does exist in the distribution and is referred to in the online
Version-Release number of selected component (if applicable):
comps release 4AS-0.20050107
Steps to Reproduce:
1. grep kernel-doc /usr/share/comps/$(uname -i)/comps.xml
kernel-doc does not exist on the system as per RHEL4 Reference Guide
"Some of the best documentation about the proc file system is installed on the
system by default
Yet /usr/share/doc/kernel-doc-<version> doesn't exist
CC'd to Andrius Benokraitis as I refer to
kernel-doc gets installed by default (or not), that's up to you to agree on
For reference in RHEL3 kernel-doc was classed under the kernel-development group
which does not exist under RHEL4.
In neither RHEL3 or RHEL4 is the kernel-doc package mandatory therefore the
rhel-rg in both cases (rhel-rg, Section 5.5.1) regarding the docs being
installed by default is probably incorrect.
To clarify the section in my original report entitled
[ using the word "mandatory" previously has specific implications in regards to
comps.xml and installation so I'll re-phrase ]
In neither RHEL3 nor RHEL4 is the kernel-doc package included on the system by
default. I have verified this with default settings installations of
RHEL3-U4-AS-i386 (text mode install)
RHEL4-U0-AS-i386 (text mode install)
rhel-rg(EN)-4-HTML-RHI (2004-09-30T17:13), Section 5.5.1, and
rhel-rg(EN)-3-HTML-RHI (2003-07-25T17:13), Section 5.5.1
should probably refer to installing the kernel-doc package.
Thanks for CC'ing me... depending on how the developer proceeds on this bug, I
can develop a DOCS strategy from there.
Standing by for developer input, and added this bug to RHEL5 Reference Guide
tracking bug (just in case, as a reminder).
Ok, I have added kernel-doc to comps. It is an optional package in the 'System
Tools' group. Reassigning to Andrius.
Mike, does that mean the kernel-doc package needs to still be "checked on" or is
it installed by default now as well? thanks!
yes, if a user wants it, they will have to select it within the system-tools group.
Would it be unreasonable to have the package installed by default? :-) How much
space does it take up on the disk? Thanks!
If we installed by default all packages that anyone asked to be installed by
default, the minimal install would be far from minimal. This package consumes
11M on my machine, so it's kind of on the large side.
Having the package selectable at install time is an improvement and should be
sufficient given that most people do not need this package.
Let's ensure its removal for 4.5 from the RG
edited to read:
"<para>Below is a list of directories you can consult for more information about
the <filename>proc</filename> file system. These documents are installed through
the <filename>kernel-doc</filename> package.</para>"
reassigning to mhideo, to have the updated RG pushed to the docs site. thanks!