Man pages are not installed for app-emulation/qemu-5.2.0-r2 (without the doc USE flag) on aarch64-gentoo-linux-musl.
$ man qemu-img
No manual entry for qemu-img
$ man qemu-system-aarch64
No manual entry for qemu-system-aarch64
"find /usr/share/man/ -iname '*qemu*'" doesn't return anything
Created attachment 687003 [details]
Created attachment 687006 [details]
Created attachment 687009 [details]
This happens everywhere, man pages need sphinx and docs to be enabled to be generated.
And, while not up to me, I'd certainly prefer if qemu didn't start pulling sphinx unconditionally.
So, if not pulling but still fixing this, it'd need a maintainer-made man pages tarball used when USE=-doc
(In reply to Zulu Foxtrott from comment #0)
> Man pages are not installed for app-emulation/qemu-5.2.0-r2 (without the doc
> USE flag) on aarch64-gentoo-linux-musl.
> Reproducible: Always
> Actual Results:
> $ man qemu-img
> No manual entry for qemu-img
> $ man qemu-system-aarch64
> No manual entry for qemu-system-aarch64
> "find /usr/share/man/ -iname '*qemu*'" doesn't return anything
This works as intended. What was your expectation?
I expected man pages to not count as "extra documentation" (description of the "doc" USE flag: "Add extra documentation (API, Javadoc, etc).") AFAIU most packages install man pages even when the "doc" USE flag is not set.
Would renaming use flag to USE=man make it more clear?
I thought about USE=man as well but USE=doc also provide other docs and build system doesn't support separating them, e.g. trades for "docs missing when USE=-man", plus qemu's option is named "docs".
(In reply to Ionen Wolkens from comment #8)
> [...] but USE=doc also provide other docs and build system doesn't support separating them
Yes, this is the underlying issue here.
I am not really sold on an additional USE=man toggle - I think the ebuild has already way too many use flags.
Renaming USE=doc to USE=man also doesn't sound particularly fitting - after all it installs a lot of additional documentation.
As a pragmatic workaround we could simply default-enable doc by setting it to +doc. This should solve the problem for 99% of the users... (and those who set USE=-doc in their global use flags should now what they're doing...).
Default enabling sounds good. Given time permits I'll document this behaviour on wgo.
The bug has been closed via the following commit(s):
Author: Matthias Maier <email@example.com>
AuthorDate: 2021-04-04 19:30:37 +0000
Commit: Matthias Maier <firstname.lastname@example.org>
CommitDate: 2021-04-04 19:31:00 +0000
app-emulation/qemu: default enable USE=+doc
Package-Manager: Portage-3.0.18, Repoman-3.0.3
Signed-off-by: Matthias Maier <email@example.com>
app-emulation/qemu/qemu-5.2.0-r2.ebuild | 2 +-
app-emulation/qemu/qemu-5.2.0-r3.ebuild | 2 +-
app-emulation/qemu/qemu-9999.ebuild | 2 +-
3 files changed, 3 insertions(+), 3 deletions(-)