* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-mips-stage.xml hb-install-stage.xml
@ 2009-07-22 5:05 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 3+ messages in thread
From: Joshua Saddler (nightmorph) @ 2009-07-22 5:05 UTC (permalink / raw
To: gentoo-doc-cvs
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>
^ permalink raw reply [flat|nested] 3+ messages in thread
* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-mips-stage.xml hb-install-stage.xml
@ 2010-08-28 23:42 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 3+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-08-28 23:42 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 10/08/28 23:42:23
Modified: hb-install-mips-stage.xml hb-install-stage.xml
Log:
adjust MAKEOPTS suggestion for multiple cores, bug 334719
Revision Changes Path
1.12 xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.12&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.12&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?r1=1.11&r2=1.12
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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- hb-install-mips-stage.xml 27 Jul 2010 22:54:33 -0000 1.11
+++ hb-install-mips-stage.xml 28 Aug 2010 23:42:23 -0000 1.12
@@ -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-mips-stage.xml,v 1.11 2010/07/27 22:54:33 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml,v 1.12 2010/08/28 23:42:23 nightmorph Exp $ -->
<sections>
@@ -13,8 +13,8 @@
describe how you extract the stage3 archive and configure Portage.
</abstract>
-<version>10.0</version>
-<date>2010-07-27</date>
+<version>10.1</version>
+<date>2010-08-28</date>
<section>
<title>Installing a Stage Tarball</title>
@@ -398,8 +398,8 @@
<p>
With <c>MAKEOPTS</c> you define how many parallel compilations should occur when
-you install a package. A good choice is the number of CPUs in your system plus
-one, but this guideline isn't always perfect.
+you install a package. A good choice is the number of CPUs (or CPU cores) in
+your system plus one, but this guideline isn't always perfect.
</p>
<pre caption="MAKEOPTS for a regular, 1-CPU system">
1.122 xml/htdocs/doc/en/handbook/hb-install-stage.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.122&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.122&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.121&r2=1.122
Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.121
retrieving revision 1.122
diff -u -r1.121 -r1.122
--- hb-install-stage.xml 19 Jul 2010 05:59:23 -0000 1.121
+++ hb-install-stage.xml 28 Aug 2010 23:42:23 -0000 1.122
@@ -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.121 2010/07/19 05:59:23 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.122 2010/08/28 23:42:23 nightmorph Exp $ -->
<sections>
@@ -13,8 +13,8 @@
describe how you extract the stage3 archive and configure Portage.
</abstract>
-<version>10.4</version>
-<date>2010-07-18</date>
+<version>10.5</version>
+<date>2010-08-28</date>
<section>
<title>Installing a Stage Tarball</title>
@@ -456,8 +456,8 @@
<p>
With <c>MAKEOPTS</c> you define how many parallel compilations should occur when
-you install a package. A good choice is the number of CPUs in your system plus
-one, but this guideline isn't always perfect.
+you install a package. A good choice is the number of CPUs (or CPU cores) in
+your system plus one, but this guideline isn't always perfect.
</p>
<pre caption="MAKEOPTS for a regular, 1-CPU system">
^ permalink raw reply [flat|nested] 3+ messages in thread
* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-mips-stage.xml hb-install-stage.xml
@ 2012-12-09 15:33 Sven Vermeulen (swift)
0 siblings, 0 replies; 3+ messages in thread
From: Sven Vermeulen (swift) @ 2012-12-09 15:33 UTC (permalink / raw
To: gentoo-doc-cvs
swift 12/12/09 15:33:17
Modified: hb-install-mips-stage.xml hb-install-stage.xml
Log:
Fix bug #446604 - Update link since moving portage tree installation further
Revision Changes Path
1.13 xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.13&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.13&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?r1=1.12&r2=1.13
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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- hb-install-mips-stage.xml 28 Aug 2010 23:42:23 -0000 1.12
+++ hb-install-mips-stage.xml 9 Dec 2012 15:33:17 -0000 1.13
@@ -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-mips-stage.xml,v 1.12 2010/08/28 23:42:23 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml,v 1.13 2012/12/09 15:33:17 swift Exp $ -->
<sections>
@@ -13,8 +13,8 @@
describe how you extract the stage3 archive and configure Portage.
</abstract>
-<version>10.1</version>
-<date>2010-08-28</date>
+<version>11</version>
+<date>2012-12-09</date>
<section>
<title>Installing a Stage Tarball</title>
@@ -203,54 +203,13 @@
<p>
Now that the stage is installed, continue with <uri
-link="#installing_portage">Installing Portage</uri>.
+link="#compile_options">Configuring the Compile Options</uri>.
</p>
</body>
</subsection>
</section>
-<section id="installing_portage">
-<title>Installing Portage</title>
-<subsection>
-<title>Unpacking a Portage Snapshot</title>
-<body>
-
-<p>
-You now have to install a Portage snapshot, a collection of files that inform
-Portage what software titles you can install, which profiles are available, etc.
-</p>
-
-</body>
-</subsection>
-<subsection id="installing_from_Internet">
-<title>Download and Install a Portage Snapshot</title>
-<body>
-
-<p>
-Go to the mountpoint where you mounted your filesystem (most likely
-<path>/mnt/gentoo</path>):
-</p>
-
-<pre caption="Going to the Gentoo mountpoint">
-# <i>cd /mnt/gentoo</i>
-</pre>
-
-<p>
-Download a portage snapshot from a <uri
-link="/main/en/mirrors.xml">local mirror</uri>.
-You'll find them in the <path>snapshots/</path> directory. Transfer it to the
-target system in the same manner that you did for the stage tarball.
-</p>
-
-<pre caption="Extracting the Portage snapshot">
-# <i>tar -xjf portage-*.tar.bz2 -C /mnt/gentoo/usr</i>
-</pre>
-
-</body>
-</subsection>
-</section>
-
<section id="compile_options">
<title>Configuring the Compile Options</title>
<subsection>
1.131 xml/htdocs/doc/en/handbook/hb-install-stage.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.131&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.131&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.130&r2=1.131
Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.130
retrieving revision 1.131
diff -u -r1.130 -r1.131
--- hb-install-stage.xml 9 Dec 2012 13:29:00 -0000 1.130
+++ hb-install-stage.xml 9 Dec 2012 15:33:17 -0000 1.131
@@ -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.130 2012/12/09 13:29:00 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.131 2012/12/09 15:33:17 swift Exp $ -->
<sections>
@@ -13,7 +13,7 @@
describe how you extract the stage3 archive and configure Portage.
</abstract>
-<version>17</version>
+<version>18</version>
<date>2012-12-09</date>
<section>
@@ -189,7 +189,7 @@
<p>
Now that the stage is installed, continue with <uri
-link="#installing_portage">Installing Portage</uri>.
+link="#compile_options">Configuring the Compile Options</uri>.
</p>
</body>
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2012-12-09 18:02 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-07-22 5:05 [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-mips-stage.xml hb-install-stage.xml Joshua Saddler (nightmorph)
-- strict thread matches above, loose matches on Subject: below --
2010-08-28 23:42 Joshua Saddler (nightmorph)
2012-12-09 15:33 Sven Vermeulen (swift)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox