Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-mips-stage.xml hb-install-stage.xml
Date: Wed, 22 Jul 2009 05:05:23
Message-Id: E1MTU11-0002HG-St@stork.gentoo.org
1 nightmorph 09/07/22 05:05:19
2
3 Modified: hb-install-mips-stage.xml hb-install-stage.xml
4 Log:
5 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.
6
7 Revision Changes Path
8 1.10 xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.10&view=markup
11 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
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?r1=1.9&r2=1.10
13
14 Index: hb-install-mips-stage.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml,v
17 retrieving revision 1.9
18 retrieving revision 1.10
19 diff -u -r1.9 -r1.10
20 --- hb-install-mips-stage.xml 1 Apr 2008 08:53:46 -0000 1.9
21 +++ hb-install-mips-stage.xml 22 Jul 2009 05:05:19 -0000 1.10
22 @@ -4,12 +4,12 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $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 $ -->
27 +<!-- $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 $ -->
28
29 <sections>
30
31 -<version>9.0</version>
32 -<date>2008-04-01</date>
33 +<version>9.1</version>
34 +<date>2009-07-21</date>
35
36 <section>
37 <title>Installing a Stage Tarball</title>
38 @@ -337,9 +337,11 @@
39 A second one is the <c>-O</c> flag (that is a capital O, not a zero),
40 which specifies the <c>gcc</c> optimization
41 class flag. Possible classes are <c>s</c> (for size-optimized),
42 -<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or <c>3</c> for more
43 +<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or even <c>3</c> for more
44 speed-optimization flags (every class has the same flags as the one before, plus
45 -some extras). For instance, for a class-2 optimization:
46 +some extras). <c>-O2</c> is the recommended default. <c>-O3</c> is known to
47 +cause problems when used system-wide, so we recommend that you stick to
48 +<c>-O2</c>.
49 </p>
50
51 <pre caption="The GCC O setting">
52 @@ -377,6 +379,12 @@
53 CXXFLAGS="${CFLAGS}" <comment># Use the same settings for both variables</comment>
54 </pre>
55
56 +<note>
57 +You may also want to view the <uri
58 +link="/doc/en/gcc-optimization.xml">Compilation Optimization Guide</uri> for
59 +more information on how the various compilation options can affect your system.
60 +</note>
61 +
62 </body>
63 </subsection>
64 <subsection>
65
66
67
68 1.116 xml/htdocs/doc/en/handbook/hb-install-stage.xml
69
70 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.116&view=markup
71 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.116&content-type=text/plain
72 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.115&r2=1.116
73
74 Index: hb-install-stage.xml
75 ===================================================================
76 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
77 retrieving revision 1.115
78 retrieving revision 1.116
79 diff -u -r1.115 -r1.116
80 --- hb-install-stage.xml 6 Apr 2008 21:10:23 -0000 1.115
81 +++ hb-install-stage.xml 22 Jul 2009 05:05:19 -0000 1.116
82 @@ -4,7 +4,7 @@
83 <!-- The content of this document is licensed under the CC-BY-SA license -->
84 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
85
86 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.115 2008/04/06 21:10:23 nightmorph Exp $ -->
87 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.116 2009/07/22 05:05:19 nightmorph Exp $ -->
88
89 <sections>
90
91 @@ -13,8 +13,8 @@
92 describe how you extract the stage3 archive and configure Portage.
93 </abstract>
94
95 -<version>9.1</version>
96 -<date>2008-04-06</date>
97 +<version>9.2</version>
98 +<date>2009-07-21</date>
99
100 <section>
101 <title>Installing a Stage Tarball</title>
102 @@ -413,9 +413,11 @@
103 A second one is the <c>-O</c> flag (that is a capital O, not a zero),
104 which specifies the <c>gcc</c> optimization
105 class flag. Possible classes are <c>s</c> (for size-optimized),
106 -<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or <c>3</c> for more
107 +<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or even <c>3</c> for more
108 speed-optimization flags (every class has the same flags as the one before, plus
109 -some extras). <c>-O2</c> is the recommended default.
110 +some extras). <c>-O2</c> is the recommended default. <c>-O3</c> is known to
111 +cause problems when used system-wide, so we recommend that you stick to
112 +<c>-O2</c>.
113 </p>
114
115 <p>
116 @@ -448,6 +450,12 @@
117 CXXFLAGS="${CFLAGS}"
118 </pre>
119
120 +<note>
121 +You may also want to view the <uri
122 +link="/doc/en/gcc-optimization.xml">Compilation Optimization Guide</uri> for
123 +more information on how the various compilation options can affect your system.
124 +</note>
125 +
126 </body>
127 </subsection>
128 <subsection>