nightmorph 09/07/22 05:05:19 Modified: hb-install-mips-stage.xml 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.10 xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.10&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.10&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?r1=1.9&r2=1.10 Index: hb-install-mips-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- hb-install-mips-stage.xml 1 Apr 2008 08:53:46 -0000 1.9 +++ hb-install-mips-stage.xml 22 Jul 2009 05:05:19 -0000 1.10 @@ -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/hb-install-mips-stage.xml,v 1.9 2008/04/01 08:53:46 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml,v 1.10 2009/07/22 05:05:19 nightmorph Exp $ --> <sections> -<version>9.0</version> -<date>2008-04-01</date> +<version>9.1</version> +<date>2009-07-21</date> <section> <title>Installing a Stage Tarball</title> @@ -337,9 +337,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). For instance, for a class-2 optimization: +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> <pre caption="The GCC O setting"> @@ -377,6 +379,12 @@ CXXFLAGS="${CFLAGS}" <comment># Use the same settings for both variables</comment> </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> 1.116 xml/htdocs/doc/en/handbook/hb-install-stage.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.116&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.116&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.115&r2=1.116 Index: hb-install-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v retrieving revision 1.115 retrieving revision 1.116 diff -u -r1.115 -r1.116 --- hb-install-stage.xml 6 Apr 2008 21:10:23 -0000 1.115 +++ hb-install-stage.xml 22 Jul 2009 05:05:19 -0000 1.116 @@ -4,7 +4,7 @@ <!-- 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/hb-install-stage.xml,v 1.115 2008/04/06 21:10:23 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.116 2009/07/22 05:05:19 nightmorph Exp $ --> <sections> @@ -13,8 +13,8 @@ describe how you extract the stage3 archive and configure Portage. </abstract> -<version>9.1</version> -<date>2008-04-06</date> +<version>9.2</version> +<date>2009-07-21</date> <section> <title>Installing a Stage Tarball</title> @@ -413,9 +413,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> @@ -448,6 +450,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>
