[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook/2008.0: hb-install-stage.xml

[Joshua Saddler (nightmorph)]

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>