nightmorph 09/07/22 05:05:20 Modified: hb-install-stage.xml Log: make it a little more clear that -O2 is the recommended default, -O3 is a bad idea. also link to the compilation optimization guide for more info.
Revision Changes Path 1.8 xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml?rev=1.8&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml?rev=1.8&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml?r1=1.7&r2=1.8 Index: hb-install-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- hb-install-stage.xml 8 Jul 2008 23:56:10 -0000 1.7 +++ hb-install-stage.xml 22 Jul 2009 05:05:20 -0000 1.8 @@ -4,12 +4,12 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml,v 1.7 2008/07/08 23:56:10 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-stage.xml,v 1.8 2009/07/22 05:05:20 nightmorph Exp $ --> <sections> -<version>9.4</version> -<date>2008-07-08</date> +<version>9.5</version> +<date>2009-07-21</date> <section> <title>Installing a Stage Tarball</title> @@ -257,9 +257,11 @@ A second one is the <c>-O</c> flag (that is a capital O, not a zero), which specifies the <c>gcc</c> optimization class flag. Possible classes are <c>s</c> (for size-optimized), -<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or <c>3</c> for more +<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or even <c>3</c> for more speed-optimization flags (every class has the same flags as the one before, plus -some extras). <c>-O2</c> is the recommended default. +some extras). <c>-O2</c> is the recommended default. <c>-O3</c> is known to +cause problems when used system-wide, so we recommend that you stick to +<c>-O2</c>. </p> <p> @@ -286,6 +288,12 @@ CXXFLAGS="${CFLAGS}" </pre> +<note> +You may also want to view the <uri +link="/doc/en/gcc-optimization.xml">Compilation Optimization Guide</uri> for +more information on how the various compilation options can affect your system. +</note> + </body> </subsection> <subsection>
