Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 624464

Summary: sys-kernel/dracut Support USE=doc
Product: Gentoo Linux Reporter: Troy C <troxor0>
Component: Current packagesAssignee: Alexander Tsoy <alexander>
Status: UNCONFIRMED ---    
Severity: minor CC: alexander, floppym, jstein, simon.vanderveldt+gentoo
Priority: Normal Keywords: PullRequest
Version: unspecified   
Hardware: All   
OS: Linux   
See Also: https://github.com/gentoo/gentoo/pull/12181
Whiteboard:
Package list:
Runtime testing required: ---
Attachments: support USE=doc in dracut ebuild

Description Troy C 2017-07-10 15:16:22 UTC
Created attachment 482892 [details, diff]
support USE=doc in dracut ebuild

Hello,

Attached is a suggested patch to make documentation optional, avoiding dependencies on asciidoc and others.

Let me know if something is missing or incorrect, but this worked on my system in a quick test.

Thanks!
Comment 1 Alexander Tsoy 2018-03-11 22:39:34 UTC
Comment on attachment 482892 [details, diff]
support USE=doc in dracut ebuild

>+       doc? (
>+               app-text/asciidoc
>+               >=dev-libs/libxslt-1.1.26
>+               app-text/docbook-xml-dtd:4.5
>+               >=app-text/docbook-xsl-stylesheets-1.75.2
>+       )

dracut release tarballs contain pregenerated documentation and man pages, so these dependencies actually not needed. But if we remove them, we should be more careful when backporting patches, since they may contain documentation changes and trigger documentation regeneration.
Comment 2 Simon 2018-10-18 20:53:41 UTC
@Alexander if pregenerated docs are included we can just simply remove the asciidoc and the other docs related dependencies, right?
Comment 3 Alexander Tsoy 2019-01-11 21:46:37 UTC
I had to switch to github mirror when preparing 049 release as there is no 049 tarball on the kernel.org mirrors. The source tarball from github doesn't contain pregenerated documentation.

I guess it should be allowed by gentoo policy to introduce local "doc" USE-flag that also controls manpages installation (pass --disable-documentation to configure when USE=-doc). This USE-flag should be enabled by default of course.
Comment 4 Simon 2019-02-26 18:46:56 UTC
I've pinged the dracut devs more than a month ago here https://github.com/dracutdevs/dracut/issues/520 for some info regarding the availability of source code on the kernel.org mirror, unfortunately no answer so far.

I guess we're better off just pulling from GitHub.
Since there are no docs in the releases on GitHub adding a "doc" USE flag and enabling it by default seems like a decent solution.