Bug 265664

Summary:	Gentoo GCC Upgrade Guide might be wrong
Product:	[OLD] Docs on www.gentoo.org	Reporter:	hitachi <mail>
Component:	Other documents	Assignee:	Wernfried Haas (RETIRED) <amne>
Status:	RESOLVED DUPLICATE
Severity:	normal	CC:	halcy0n, jkt, nightmorph
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description hitachi 2009-04-10 15:29:56 UTC

Reading the upgrade guide makes me believe it is wrong. The guide is placed here:
http://www.gentoo.org/doc/en/gcc-upgrading.xml

1. Point 4.5 "Code Listing 4.5: Cleaning up" tells me to unmerge the new version. This must be wrong. Also one might advise the reader to use the prune option as well.

2. At the end of 2.1 is written: "To be completely safe that your system is in a sane state, you must rebuild the toolchain and then world to make use of the new compiler." One should better point out that in most cases this isn't necessary. There might be problems, yes. But as long as the ABI doesn't change always doing an emerge -eav world is just a wast of time an natural resources such as energy.

Reproducible: Always

Steps to Reproduce:
1. Visit the guide http://www.gentoo.org/doc/en/gcc-upgrading.xml
2. Read the mention sections

Comment 1 Lars Wendler (Polynomial-C) (RETIRED) gentoo-dev

2009-04-10 15:38:08 UTC

Product should be "Documentation"

Comment 2 Xavier Neys (RETIRED) gentoo-dev

2009-04-10 16:37:04 UTC


*** This bug has been marked as a duplicate of bug 230407 ***

Comment 3 hitachi 2009-04-10 19:31:38 UTC

For 1:
I see the point and still I think it would be much better to write it in a different way. It is placed in the section for fresh install which will most likely also be important for people new to gentoo. They might misunderstand it as well.

For 2:
There is now answer to this point why the bug should be reopened therefore.