Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 949398 - sys-devel/gcc-14.2.1_p20241221: should BDEPEND on app-text/doxygen when USE=doc is enabled
Summary: sys-devel/gcc-14.2.1_p20241221: should BDEPEND on app-text/doxygen when USE=d...
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal
Assignee: Gentoo Toolchain Maintainers
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-02-07 17:09 UTC by zurabid2016
Modified: 2025-02-07 18:04 UTC (History)
1 user (show)

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description zurabid2016 2025-02-07 17:09:42 UTC
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.
Comment 1 zurabid2016 2025-02-07 17:14:01 UTC
To clarify: A warning is produced when USE="doc", but app-text/doxygen is *not* installed.
Comment 2 Larry the Git Cow gentoo-dev 2025-02-07 18:04:50 UTC
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(-)