AFAICS, Gentoo policy is *not* to pull in Documentation as default.
Setting global "doc" in /etc/portage/make.conf is discouraged as well.
Please, c.f. [ https://bugs.gentoo.org/802618#c11 ]
(In reply to Manfred Knick from comment #0)
> AFAICS, Gentoo policy is *not* to pull in Documentation as default.
> Setting global "doc" in /etc/portage/make.conf is discouraged as well.
> Reproducible: Always
Note that it might well be to get man pages.
It does seem to be required to get manpages. The size difference between USE=doc and not is ~14mb. This isn't really significant on most modern hardware, and Sphinx isn't really heavy, so I think this is an appropriate tradeoff to get manpages by default. So, if Sphinx or the size impact is really a problem for you, I'd just suggest turning off USE=doc.
I'll leave this open for a while in case anyone else has an opinion, though.
Optimal would be to provide a man page tarball in SRC_URI (used when USE=-doc) to satisfy both this and bug #770997 that wanted man pages by default, qemu doesn't update all that often and generating it shouldn't be much of a burden imo.
At one point there was consideration to make this a policy (man pages always available by default without USE, and if non-trivial deps then build them) but not all devs liked the added burden.
(In reply to Ionen Wolkens from comment #5)
> Optimal would be to provide a man page tarball in SRC_URI
On a side-note, /if/ going that route (I don't really mind either way personally), including the script used to generate the man page tarball in the tarball itself tend to be useful.
Personally, if possible, I'd suggest to treat manpages and docs as 2 different things and with 2 differents IUSE (eg: doc and man, I see man IUSE is used in other cases too ). Other than that, if not possible to follow my suggestion, I agree with what have been said before me: dropping a doc USE is not a good idea, because it contains manpages too.
(In reply to Sam James from comment #3)
> Note that it might well be to get man pages.
Sorry - caught by surprise: Filing this bug,
I would never have expected this intermixture.
(In reply to Marco Scardovi (scardracs) from comment #7)
> ... treat manpages and docs as 2 different things ...
The qemu build system uses sphinx internally to build docs and manpages and provides a single configuration option "docs" to enable or disable this build.
Because man pages are a very useful thing to have by default the use flag is enabled by default.
We would need to patch the build system in order to allow to build man pages independently from the rest of the html documentation. But honestly what do we gain by that?
This just creates a maintenance burden for very little gain.
If you really do not want to see the documentation installed, you can already either set USE=-doc, or use INSTALL_MASK="/usr/share/doc/qemu-*" to prevent any installation of documentation.
(In reply to Matthias Maier from comment #9)
Perhaps you might like to note that "htop" displays
"Add extra documentation (API, Javadoc, etc.)
It is recommended to enable per package instead of globally
which - in my case - worked misleading.
> This just creates a maintenance burden for very little gain.
Thanks a lot for your explanation!