The FAQ says at chapter 2: "I'm finding things to be really unstable and I'm using "-O9 -ffast-math -fomit-frame-pointer" optimizations. What gives? When you use any optimizations beyond -O3, you're [...]" But gcc 3.x doesn't have anything above -O3, so using -O69 is useless and with (almost ?) no gcc 2.95 users anymore and with (almost ?) no support for Gentoo 1.2 this could be a bit confusing since someone might believe there _is_ something above -O3. Perhaps add a little hint that it only applies to gcc 2 or - which would be better - rephrase that part of the FAQ
reassigned to docs-team@gentoo.org btw: it doesn't even apply to gcc 2.9x, so my suggestion would be to just add a little information about nothing bigger than -O3 being available, just to make it clear since "when you use any optimizations beyoond -O3, you're [...]" sounds like "anything higher than -O3" and not "any additional flags". Ok, I admit I am a bit petty ;)
Note added to FAQ: --- Don't bother using anything higher than <c>-O3<c> since it isn't support by current versions of gcc. ---