Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 273654 - sys-devel/gcc no longer builds c++ stl man pages with USE="doc"
Summary: sys-devel/gcc no longer builds c++ stl man pages with USE="doc"
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Core system (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Gentoo Toolchain Maintainers
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-06-10 21:38 UTC by David Flogeras
Modified: 2011-12-05 18:38 UTC (History)
4 users (show)

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


Attachments
libstdc++-manpages/libstdc++-manpages-4.3.0.ebuild (libstdc++-manpages-4.3.0.ebuild,535 bytes, text/plain)
2009-09-18 19:47 UTC, Siim Ainsaar
Details

Note You need to log in before you can comment on or make changes to this bug.
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 gentoo-dev 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 gentoo-dev 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 :)