Bug 273654 – sys-devel/gcc no longer builds c++ stl man pages with USE="doc"

• Product: Gentoo Linux
• Status: RESOLVED FIXED

[Description David Flogeras 2009-06-10 21:38:57 UTC]

I recall at least with gcc 3.4.6 build with USE="doc" you used to get the whole STL in manpages.  This is no longer the case (with at least 4.3.2, unsure about 4.1.x as its not on any of my systems any longer).

Is this possible to get back?  Or has upstream stopped supplying them.  Could another package be introduced to meet this end?

Reproducible: Always

[Comment 1 Kevin Pyle 2009-06-12 03:05:40 UTC]

sys-devel/gcc-4.1.2 with USE=doc has STL man pages for me.  According to <http://gcc.gnu.org/gcc-4.3/changes.html>, the documentation has been reworked and can now be viewed online.  It is supposedly included with the source tree as well, but the "API and Source Level Documentation" has only an index file in the source tree.  The rest of it is probably built at some phase.  Prebuilt tarballs of both manual pages and HTML pages are available at <ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/> and corresponding mirrors.  The most expedient approach may be to handle the STL documentation similar to how Gentoo presently handles Python documentation: have USE=doc add a dependency on a separate package which just installs the documentation.  That would allow users to install or remove documentation later without rebuilding the compiler.

[Comment 2 Siim Ainsaar 2009-09-18 19:47:54 UTC]

Created attachment 204541 [details]
libstdc++-manpages/libstdc++-manpages-4.3.0.ebuild

An ebuild for convenience, until a full solution (useflags etc) comes out.

[Comment 3 Siim Ainsaar 2009-09-18 19:53:26 UTC]

Sorry for a careless copy-paste in the ebuild I posted, its description should rather read something like "Collection of libstdc++ manpages, mostly STL".

[Comment 4 David Flogeras 2011-11-16 19:42:29 UTC]

I've noticed that the toolchain eclass now tries to build gcc's libstdc++ doxygen man pages if USE=doc is set (I found out since I have a system where USE=doc is set, but doxygen itself is not installed, and i got a warning).

However, it doesn't result in any difference after the package is merged.  With or without doxygen, the STL manpages are not generated (in fact no new man pages are made)

Is this bug the right spot for this still?  I know it is old, should I open a new bug, or is someone still monitoring this?

[Comment 5 SpanKY 2011-12-02 20:34:59 UTC]

Comment on attachment 204541 [details]
libstdc++-manpages/libstdc++-manpages-4.3.0.ebuild

while i like the idea of this ebuild, i'm not sure upstream keeps the tarballs up to date enough for it to be too useful :(

atm, it looks like 4.5.2 is the latest posted ... and we're at 4.5.3 / 4.6.2

[Comment 6 SpanKY 2011-12-02 21:03:37 UTC]

the original issue of man pages not being installed with gcc-4.3+ should now be fixed by the commit:
http://sources.gentoo.org/eclass/toolchain.eclass?r1=1.483&r2=1.484

[Comment 7 David Flogeras 2011-12-05 18:38:41 UTC]

(In reply to comment #6)
> the original issue of man pages not being installed with gcc-4.3+ should now be
> fixed by the commit:
> http://sources.gentoo.org/eclass/toolchain.eclass?r1=1.483&r2=1.484

Thanks, just re-emerged gcc 4.5.3-r1 and got back my manpages :)