From e.g. [1] I can read the following (written by amne): "Using revdep-rebuild is not as safe as really rebuilding all packages, and only worked for the 3.3->3.4 transition. It is not intended for the update to 4.1." Yet the heading of chapter 3 in the official gcc upgrade guide says: "3. Upgrading from GCC-3.3 to 3.4 or greater" Now one could argue that gcc-4.1.x is indeed greater than 3.4... Hence I suggest changing that header to: "3. Upgrading from GCC-3.3.x to 3.4.x" [1] http://forums.gentoo.org/viewtopic-t-493662.html
You're partly right, but if you upgrade from 3.3 to 4.1 (which is greater than 3.4), you need to follow the instructions for upgrading from 3.3, not the general ones. In "the choices" it says "If you upgrade from gcc 3.3 to 4.1, do not use the method based on revdep-rebuild, but do a complete system rebuild" which is described below (and still belongs to the 3.3 to 4.1 chapter). Perhaps this can be made more clear somehow, but the header itself is correct here.
I see. I was filing this bug because of users having problems with upgrades from 3.3 to 4.1.x. But now I see that it is actually written there. Just have to read every letter in order to avoid confusion..
Thanks Bo, still probably a good idea to improve that. I suppose it couldn't hurt to put "If you upgrade from gcc 3.3 to 4.1, do not use the method based on revdep-rebuild, but do a complete system rebuild" into <impo> tags - docs team, could someone take care of it?
Yeah, perhaps copying the sentence from chapter 3 that says: "If you upgrade from gcc 3.3 to 4.1, do not use the method based on revdep-rebuild, but do a complete system rebuild. [1]" [1] http://www.gentoo.org/doc/en/gcc-upgrading.xml#upgrade-3.3-to-3.4-emerge-e to the bottom of chapter 1 in an important box would make it less confusing.
Fixed in CVS, thanks for reporting.
Sorry, I should have changed the topic sooner. Hope this topic is appropriate...
Gah.. Chapter 1 that is.
Okay, so I have included the instructions from a situation where we're upgrading from 3.3 to 4.1 in the *general*, not the 3.3->3.4 specific instructions. Also added a blurb about libstdc++-v3. Hope it's all correct now. Thanks to amne & zlin for explaining.