gcc has a USE flag "doc" that enables building and installing documentation (including C++ STL documentation). app-text/doxygen is utilised to build documentation, while not being a BDEPEND of gcc. The documentation is built automagically, i.e. by detecting whether doxygen is installed on the system, producing a warning if USE=doc and doxygen is not present[1]. I think that doxygen should be made into a proper USE-conditional build dependency. [1]: https://gitweb.gentoo.org/repo/gentoo.git/tree/eclass/toolchain.eclass#n2350 Reproducible: Always Steps to Reproduce: 1. Do not have app-text/doxygen installed. (`qlist -Ive app-text/doxygen` should not print anything) 2. emerge sys-devel/gcc with the "doc" USE flag enabled. Actual Results: After emerging gcc, *no* additional documentation (e.g., C++ STL manpages in man/man3) is installed. Expected Results: 3. After emerging gcc, additional documentation (e.g., C++ STL manpages in man/man3) is present.
To clarify: A warning is produced when USE="doc", but app-text/doxygen is *not* installed.
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=672b4e16d50c895f63ed0dffd13b127735adaa89 commit 672b4e16d50c895f63ed0dffd13b127735adaa89 Author: Sam James <sam@gentoo.org> AuthorDate: 2025-02-07 18:01:22 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2025-02-07 18:04:11 +0000 toolchain.eclass: depend on doxygen for USE=doc Needed for libstdc++ docs. This goes back to 3998c0e241690b9f5520a66c36382d6173c2bdad and 337957a79e26b67eda2ef3bd5af71f75217b32b5. I don't see why we want that behaviour these days. Closes: https://bugs.gentoo.org/949398 Signed-off-by: Sam James <sam@gentoo.org> eclass/toolchain.eclass | 27 ++++++++++++--------------- 1 file changed, 12 insertions(+), 15 deletions(-)