12:07 p.m.
I recently had to perform a bit of development/research where I often had to take a look
in the kernel documentation.
Most of the time was spend offline so I wanted to download the `kernel-doc` package
however it does not seem to exist.
Some old fedora documentations still refer to it however somewhere in the 2x iteration of
fedora it seems to have gone missing.
CentOS 8 also still has it.
Would it be possible to add this back to the repos?
12:43 p.m.
On Mon, 30 Aug 2021 at 13:07, Nils K <nilskemail+github(a)gmail.com> wrote:
I recently had to perform a bit of development/research where I often had to take a look
in the kernel documentation.
Most of the time was spend offline so I wanted to download the `kernel-doc` package
however it does not seem to exist.
Some old fedora documentations still refer to it however somewhere in the 2x iteration of
fedora it seems to have gone missing.
CentOS 8 also still has it.
Would it be possible to add this back to the repos?
It isn't that we aren't shipping it, it is that the Kernel spec file
does not generate any documentation anymore. It looks like Fedora 20
made this change but I don't know why beyond
https://bugzilla.redhat.com/show_bug.cgi?id=1223200 . While EL-8 is
based on Fedora-28, the kernel team for RHEL uses a different spec
file. It also did not start shipping with the kernel-doc but looks to
have been added with
https://bugzilla.redhat.com/show_bug.cgi?id=1659636
At this point I suggest you file a bug against the kernel and cite
those two bugs. The current kernel team can work out what work it
would be needed and if it could be added.
_______________________________________________
devel mailing list -- devel(a)lists.fedoraproject.org
To unsubscribe send an email to devel-leave(a)lists.fedoraproject.org
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives:
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
--
Stephen J Smoogen.
I've seen things you people wouldn't believe. Flame wars in
sci.astro.orion. I have seen SPAM filters overload because of Godwin's
Law. All those moments will be lost in time... like posts on a BBS...
time to shutdown -h now.
12:52 p.m.
On Mon, Aug 30, 2021 at 1:44 PM Stephen John Smoogen <smooge(a)gmail.com> wrote:
On Mon, 30 Aug 2021 at 13:07, Nils K <nilskemail+github(a)gmail.com> wrote:
>
> I recently had to perform a bit of development/research where I often had to take a
look in the kernel documentation.
>
> Most of the time was spend offline so I wanted to download the `kernel-doc` package
however it does not seem to exist.
> Some old fedora documentations still refer to it however somewhere in the 2x
iteration of fedora it seems to have gone missing.
> CentOS 8 also still has it.
> Would it be possible to add this back to the repos?
It isn't that we aren't shipping it, it is that the Kernel spec file
does not generate any documentation anymore. It looks like Fedora 20
made this change but I don't know why beyond
https://bugzilla.redhat.com/show_bug.cgi?id=1223200 . While EL-8 is
It required koji hacks to build at the time, and the Fedora kernel
revved daily. The value of producing the docs package when the same
docs are available on kernel.org was very low. We removed it.
based on Fedora-28, the kernel team for RHEL uses a different spec
file. It also did not start shipping with the kernel-doc but looks to
have been added with
https://bugzilla.redhat.com/show_bug.cgi?id=1659636
At this point I suggest you file a bug against the kernel and cite
those two bugs. The current kernel team can work out what work it
would be needed and if it could be added.
The move to ARK changed the dynamics a bit. I think there was a
request elsewhere to build it as well.
josh
11:30 a.m.
I found the origin of this change to be the following commit:
https://src.fedoraproject.org/rpms/kernel/c/b65f9ed036fca30c0684bfc6fe72d...
(which is a revert of a revert to remove the kernel-doc subpackage).
The commit also suggest that the package might be a candidate for a separate SRPM which
would maybe result in it not needing to be build everyday? Also if I understand you
correctly I assume that some of the hacks to koji are not needed anymore.
Due to this and given that RHEL includes it I think I will do as suggested and file a bug
report.
Thanks for your responses.
4:04 p.m.
On Thu, Sep 2, 2021 at 11:31 AM Nils K <nilskemail+github(a)gmail.com> wrote:
I found the origin of this change to be the following commit:
https://src.fedoraproject.org/rpms/kernel/c/b65f9ed036fca30c0684bfc6fe72d...
(which is a revert of a revert to remove the kernel-doc subpackage).
The commit also suggest that the package might be a candidate for a separate SRPM which
would maybe result in it not needing to be build everyday? Also if I understand you
correctly I assume that some of the hacks to koji are not needed anymore.
Due to this and given that RHEL includes it I think I will do as suggested and file a bug
report.
Thanks for your responses.
I suppose I can add it to the kernel-tools package since that only
gets built once per RC for rawhide, and only as needed for stable
Fedora.
Justin
11:10 a.m.
On Fri, Sep 3, 2021 at 4:04 PM Justin Forbes <jmforbes(a)linuxtx.org> wrote:
On Thu, Sep 2, 2021 at 11:31 AM Nils K <nilskemail+github(a)gmail.com> wrote:
>
> I found the origin of this change to be the following commit:
https://src.fedoraproject.org/rpms/kernel/c/b65f9ed036fca30c0684bfc6fe72d...
(which is a revert of a revert to remove the kernel-doc subpackage).
> The commit also suggest that the package might be a candidate for a separate SRPM
which would maybe result in it not needing to be build everyday? Also if I understand you
correctly I assume that some of the hacks to koji are not needed anymore.
>
> Due to this and given that RHEL includes it I think I will do as suggested and file
a bug report.
> Thanks for your responses.
I suppose I can add it to the kernel-tools package since that only
gets built once per RC for rawhide, and only as needed for stable
Fedora.
So it turns out this just becomes more work to maintain in
kernel-tools, which wasn't really set up for this. It is already
being maintained in the kernel.spec for ELN builds, so I have just
enabled it for Fedora as well. This will show up with the 5.14 rebases
as they happen.
Justin
9:46 a.m.
On Mon, 30 Aug 2021 17:07:21 -0000
"Nils K" <nilskemail+github(a)gmail.com> wrote:
I recently had to perform a bit of development/research where I
often
had to take a look in the kernel documentation.
Most of the time was spend offline so I wanted to download the
`kernel-doc` package however it does not seem to exist. Some old
fedora documentations still refer to it however somewhere in the 2x
iteration of fedora it seems to have gone missing. CentOS 8 also
still has it. Would it be possible to add this back to the repos?
Easiest would be go to the kernel.org page and use the savepage
entry in the File menu of the browser to save a copy of the
documentation. Then you can access it offline.
A more involved and clumsy workaround is to download the src.rpm
package [1] and unpack it. It is a little complicated because you have
to run
rpmdev-setuptree
to create the ~/rpmbuild heirarchy of directories and then
rpm -ivh [src.rpm]
[***NOT*** as root] to install the src.rpm in ~/rpmbuild and then
rpmbuild -bp kernel.spec
in ~/rpmbuild/SPECS
to expand the source.
The source tree containing all the documentation will then be under
~/rpmbuild/BUILD/kernel[...]/linux[...]/Documentation
1. https://koji.fedoraproject.org/koji/packageinfo?packageID=8
946
days inactive
963
days old
6 comments
5 participants
participants (5)
-
Josh Boyer -
Justin Forbes -
Nils K -
stan -
Stephen John Smoogen