Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 624464 - sys-kernel/dracut Support USE=doc
Summary: sys-kernel/dracut Support USE=doc
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal minor (vote)
Assignee: Patrick McLean
Keywords: PullRequest
Depends on:
Reported: 2017-07-10 15:16 UTC by Troy C
Modified: 2020-05-24 09:40 UTC (History)
4 users (show)

See Also:
Package list:
Runtime testing required: ---

support USE=doc in dracut ebuild (dracut.patch,1020 bytes, patch)
2017-07-10 15:16 UTC, Troy C
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Troy C 2017-07-10 15:16:22 UTC
Created attachment 482892 [details, diff]
support USE=doc in dracut ebuild


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.

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 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 for some info regarding the availability of source code on the 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.