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

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

[Xavier Neys (neysx)]

neysx       09/10/19 16:16:35

  Modified:             hb-install-stage.xml
  Log:
  #289741 mention -pipe uses more memory

Revision  Changes    Path
1.118                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.118&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.118&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.117&r2=1.118

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.117
retrieving revision 1.118
diff -u -r1.117 -r1.118
--- hb-install-stage.xml	4 Oct 2009 18:37:42 -0000	1.117
+++ hb-install-stage.xml	19 Oct 2009 16:16:35 -0000	1.118
@@ -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.117 2009/10/04 18:37:42 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.118 2009/10/19 16:16:35 neysx Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>10.0</version>
-<date>2009-10-04</date>
+<version>10.1</version>
+<date>2009-10-19</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -411,7 +411,8 @@
 <p>
 Another popular optimization flag is <c>-pipe</c> (use pipes rather than
 temporary files for communication between the various stages of compilation).
-It has no impact on the generated code.
+It has no impact on the generated code, but uses more memory. On systems with
+low memory, gcc might get killed. In that case, do not use this flag.
 </p>
 
 <p>

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

[Joshua Saddler (nightmorph)]

nightmorph    10/03/23 21:45:20

  Modified:             hb-install-stage.xml
  Log:
  livedvds don't have stages included, unfortunately. bug 310983.

Revision  Changes    Path
1.119                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.119&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.119&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.118&r2=1.119

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.118
retrieving revision 1.119
diff -u -r1.118 -r1.119
--- hb-install-stage.xml	19 Oct 2009 16:16:35 -0000	1.118
+++ hb-install-stage.xml	23 Mar 2010 21:45:20 -0000	1.119
@@ -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.118 2009/10/19 16:16:35 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.119 2010/03/23 21:45:20 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>10.1</version>
-<date>2009-10-19</date>
+<version>10.2</version>
+<date>2010-03-23</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -57,16 +57,13 @@
 <p>
 The next step you need to perform is to install the <e>stage3</e> tarball onto
 your system. You have the option of downloading the required tarball from the
-Internet or, if you booted one of the Gentoo Universal CDs or LiveDVDs, copy it
-over from the disc itself. If you have a Universal CD or LiveDVD and the stage
-you want to use is on the disc, downloading it from the Internet is just a waste
-of bandwidth as the stage files are the same. In most cases, the command
-<c>uname -m</c> can be used to help you decide which stage file to download.
+Internet or, if you booted one of the Gentoo Universal CDs, copy it over from
+the disc itself. In most cases, the command <c>uname -m</c> can be used to help
+you decide which stage file to download.
 </p>
 
 <p>
-Minimal CDs and LiveCDs do not contain any stage3 archive, though the LiveDVDs
-do.
+Minimal CDs and LiveDVDs do not contain any stage3 archive.
 </p>
 
 <ul test="not(contains('AMD64 x86', func:keyval('arch')))">

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

[Jan Kundrat (jkt)]

jkt         11/08/03 08:26:43

  Modified:             hb-install-stage.xml
  Log:
  #369841: some clarifications by swift

Revision  Changes    Path
1.123                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.123&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.123&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.122&r2=1.123

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.122
retrieving revision 1.123
diff -u -r1.122 -r1.123
--- hb-install-stage.xml	28 Aug 2010 23:42:23 -0000	1.122
+++ hb-install-stage.xml	3 Aug 2011 08:26:43 -0000	1.123
@@ -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.122 2010/08/28 23:42:23 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.123 2011/08/03 08:26:43 jkt Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>10.5</version>
-<date>2010-08-28</date>
+<version>11</version>
+<date>2011-08-03</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -95,7 +95,8 @@
 Depending on your installation medium, you have a couple of tools available to
 download a stage. If you have <c>links</c> available, then you can immediately
 surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and 
-choose a mirror close to you.
+choose a mirror close to you: type <c>links http://www.gentoo.org/main/en/mirrors.xml</c>
+and press enter.
 </p>
 
 <p>
@@ -114,11 +115,12 @@
 </p>
 
 <p>
-Move to the <path><keyval id="release-dir"/></path> directory. There you
-should see all available stage files for your architecture (they might be
-stored within subdirectories named after the individual subarchitectures).
-Select one and press <c>D</c> to download. When you're finished, press <c>Q</c>
-to quit the browser.
+Select a mirror closeby. Usually HTTP mirrors suffice, but other protocols are
+available as well. Move to the <path><keyval id="release-dir"/></path>
+directory. There you should see all available stage files for your architecture
+(they might be stored within subdirectories named after the individual
+subarchitectures). Select one and press <c>D</c> to download. When you're
+finished, press <c>Q</c> to quit the browser.
 </p>
 
 <p test="'x86'=func:keyval('arch')">

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

[Sven Vermeulen (swift)]

swift       12/10/06 19:49:18

  Modified:             hb-install-stage.xml
  Log:
  Fix bug #386475 - Use SHA512 and Whirlpool checksums for all arches except mips

Revision  Changes    Path
1.125                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.125&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.125&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.124&r2=1.125

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.124
retrieving revision 1.125
diff -u -r1.124 -r1.125
--- hb-install-stage.xml	24 Jul 2012 12:12:52 -0000	1.124
+++ hb-install-stage.xml	6 Oct 2012 19:49:18 -0000	1.125
@@ -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.124 2012/07/24 12:12:52 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.125 2012/10/06 19:49:18 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>12</version>
-<date>2012-07-24</date>
+<version>13</version>
+<date>2012-10-06</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -146,15 +146,27 @@
 
 <p>
 If you want to check the integrity of the downloaded stage tarball, use
-<c>md5sum</c> and compare the output with the MD5 checksum provided on the
-mirror.
+<c>openssl</c> and compare the output with the checksums provided on the
+mirror. The digests files provide several checksums, each taken with a different
+algorithm. The recommended ones are SHA512 and Whirlpool.
 </p>
 
-<pre caption="Checking integrity of a stage tarball">
-# <i>md5sum -c <keyval id="stage3"/>.DIGESTS</i>
-<keyval id="stage3"/>: OK
+<pre caption="Calculating the integrity checksum of a stage tarball">
+<comment>## Calculating the SHA512 checksum</comment>
+# <i>openssl dgst -r -sha512 <keyval id="stage3" /></i>
+<comment>or</comment>
+# <i>sha512sum <keyval id="stage3" /></i>
+
+<comment>## Calculating the Whirlpool checksum</comment>
+# <i>openssl dgst -r -whirlpool <keyval id="stage3" /></i>
 </pre>
 
+<p>
+Then compare the output of these commands with the value registered in the
+.DIGESTS files that can be found on the mirrors as well. The values need to
+match, otherwise the downloaded file might be corrupt (or the digests file is).
+</p>
+
 </body>
 </subsection>
 <subsection>

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

[Sven Vermeulen (swift)]

swift       12/10/31 18:55:27

  Modified:             hb-install-stage.xml
  Log:
  Fix bug #431616 - Add in reference to the march=native setting

Revision  Changes    Path
1.126                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.126&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.126&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.125&r2=1.126

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.125
retrieving revision 1.126
diff -u -r1.125 -r1.126
--- hb-install-stage.xml	6 Oct 2012 19:49:18 -0000	1.125
+++ hb-install-stage.xml	31 Oct 2012 18:55:27 -0000	1.126
@@ -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.125 2012/10/06 19:49:18 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.126 2012/10/31 18:55:27 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>13</version>
-<date>2012-10-06</date>
+<version>14</version>
+<date>2012-10-31</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -399,13 +399,17 @@
 <p test="not(contains('AMD64 x86', func:keyval('arch')))">
 A first setting is the <c>-march=</c> or <c>-mcpu=</c> flag, which specifies
 the name of the target architecture. Possible options are described in the
-<path>make.conf.example</path> file (as comments).
+<path>make.conf.example</path> file (as comments). A commonly used value is
+<e>native</e> as that tells the compiler to select the target architecture of
+the current system (the one you are installing on).
 </p>
 
 <p test="contains('AMD64 x86',func:keyval('arch'))">
 A first setting is the <c>-march=</c> or <c>-mtune=</c> flag, which specifies
 the name of the target architecture. Possible options are described in the
-<path>make.conf.example</path> file (as comments).
+<path>make.conf.example</path> file (as comments). A commonly used value is
+<e>native</e> as that tells the compiler to select the target architecture of
+the current system (the one you are installing on).
 </p>
 
 <p>

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

[Sven Vermeulen (swift)]

swift       12/12/08 18:42:05

  Modified:             hb-install-stage.xml
  Log:
  Remove reference to Universal CD

Revision  Changes    Path
1.127                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.127&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.127&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.126&r2=1.127

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.126
retrieving revision 1.127
diff -u -r1.126 -r1.127
--- hb-install-stage.xml	31 Oct 2012 18:55:27 -0000	1.126
+++ hb-install-stage.xml	8 Dec 2012 18:42:05 -0000	1.127
@@ -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.126 2012/10/31 18:55:27 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.127 2012/12/08 18:42:05 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>14</version>
-<date>2012-10-31</date>
+<version>15</version>
+<date>2012-12-08</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -56,28 +56,16 @@
 
 <p>
 The next step you need to perform is to install the <e>stage3</e> tarball onto
-your system. You have the option of downloading the required tarball from the
-Internet or, if you booted one of the Gentoo Universal CDs, copy it over from
-the disc itself. In most cases, the command <c>uname -m</c> can be used to help
-you decide which stage file to download.
+your system. The command <c>uname -m</c> can be used to help you decide which
+stage file to download as it provides information on the architecture of your
+system.
 </p>
 
-<p>
-Minimal CDs and LiveDVDs do not contain any stage3 archive.
-</p>
-
-<ul test="not(contains('AMD64 x86', func:keyval('arch')))">
-<li><uri link="#doc_chap2">Default: Using a Stage from the Internet</uri></li>
-<li>
-  <uri link="#doc_chap3">Alternative: Using a Stage from the Universal CD</uri>
-</li>
-</ul>
-
 </body>
 </subsection>
 </section>
 <section>
-<title>Default: Using a Stage from the Internet</title>
+<title>Using a Stage from the Internet</title>
 <subsection>
 <title>Downloading the Stage Tarball</title>
 <body>
@@ -141,7 +129,8 @@
 
 <p>
 Make sure you download a <b>stage3</b> tarball - installations using a stage1
-or stage2 tarball are not supported anymore.
+or stage2 tarball are not supported anymore (and in most cases, you will not
+find stage1 or stage2 tarballs on our regular download mirrors anyway).
 </p>
 
 <p>
@@ -206,6 +195,13 @@
 </body>
 </subsection>
 </section>
+<!-- 
+
+I do not notice any Universal CDs for other architectures anyhow
+TODO Remove this section
+ETA 2012-12-22
+~ SwifT
+
 <section test="not(contains('AMD64 x86', func:keyval('arch')))">
 <title>Alternative: Using a Stage from the Universal CD</title>
 <subsection>
@@ -261,6 +257,7 @@
 </body>
 </subsection>
 </section>
+-->
 <section id="installing_portage">
 <title>Installing Portage</title>
 <subsection>

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

[Joshua Saddler (nightmorph)]

nightmorph    12/12/09 09:21:13

  Modified:             hb-install-stage.xml
  Log:
  drop the ~ directory before the prompt, which doesn't fit with all our other CL instructions. no revbump; just a quick fix.

Revision  Changes    Path
1.129                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.129&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.129&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.128&r2=1.129

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.128
retrieving revision 1.129
diff -u -r1.128 -r1.129
--- hb-install-stage.xml	8 Dec 2012 20:37:21 -0000	1.128
+++ hb-install-stage.xml	9 Dec 2012 09:21:13 -0000	1.129
@@ -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.128 2012/12/08 20:37:21 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.129 2012/12/09 09:21:13 nightmorph Exp $ -->
 
 <sections>
 
@@ -277,7 +277,7 @@
 </p>
 
 <pre caption="Running emerge-webrsync to install a Portage snapshot">
-~# <i>emerge-webrync</i>
+# <i>emerge-webrync</i>
 </pre>
 
 </body>

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

[Sven Vermeulen (swift)]

swift       13/01/02 19:06:51

  Modified:             hb-install-stage.xml
  Log:
  Remove commented out section

Revision  Changes    Path
1.132                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.132&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.132&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.131&r2=1.132

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.131
retrieving revision 1.132
diff -u -r1.131 -r1.132
--- hb-install-stage.xml	9 Dec 2012 15:33:17 -0000	1.131
+++ hb-install-stage.xml	2 Jan 2013 19:06:51 -0000	1.132
@@ -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.131 2012/12/09 15:33:17 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.132 2013/01/02 19:06:51 swift Exp $ -->
 
 <sections>
 
@@ -195,69 +195,6 @@
 </body>
 </subsection>
 </section>
-<!-- 
-
-I do not notice any Universal CDs for other architectures anyhow
-TODO Remove this section
-ETA 2012-12-22
-~ SwifT
-
-<section test="not(contains('AMD64 x86', func:keyval('arch')))">
-<title>Alternative: Using a Stage from the Universal CD</title>
-<subsection>
-<title>Extracting the Stage Tarball</title>
-<body>
-
-<p>
-The stages on the CD reside in the <path>/mnt/cdrom/stages</path> directory. To
-see a listing of available stages, use <c>ls</c>:
-</p>
-
-<pre caption="List all available stages">
-# <i>ls /mnt/cdrom/stages</i>
-</pre>
-
-<p>
-If the system replies with an error, you may need to mount the CD-ROM first:
-</p>
-
-<pre caption="Mounting the CD-ROM">
-# <i>ls /mnt/cdrom/stages</i>
-ls: /mnt/cdrom/stages: No such file or directory
-# <i>mount /dev/cdroms/cdrom0 /mnt/cdrom</i>
-# <i>ls /mnt/cdrom/stages</i>
-</pre>
-
-<p>
-Now go into your Gentoo mountpoint (usually <path>/mnt/gentoo</path>):
-</p>
-
-<pre caption="Changing directory to /mnt/gentoo">
-# <i>cd /mnt/gentoo</i>
-</pre>
-
-<p>
-We will now extract the stage tarball of your choice. We will do this with
-<c>tar</c>. Make sure you use the same options (<c>xvjpf</c>). The <c>v</c>
-argument is optional and not supported in some <c>tar</c> versions.  In the next
-example, we extract the stage tarball
-<path>stage3-&lt;subarch&gt;-&lt;release&gt;.tar.bz2</path>. Be sure to
-substitute the tarball filename with your stage.
-</p>
-
-<pre caption="Extracting the stage tarball">
-# <i>tar xvjpf /mnt/cdrom/stages/stage3-&lt;subarch&gt;-&lt;release&gt;.tar.bz2</i>
-</pre>
-
-<p>
-Now that the stage is installed, continue with <uri
-link="#installing_portage">Installing Portage</uri>.
-</p>
-
-</body>
-</subsection>
-</section>
--->
 
 <section id="compile_options">
 <title>Configuring the Compile Options</title>

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

[Sven Vermeulen (swift)]

swift       13/08/03 15:03:03

  Modified:             hb-install-stage.xml
  Log:
  Fix bug #470750 - Add instructions for gpg verification of stage digest, thanks to Roman Zilka

Revision  Changes    Path
1.133                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.133&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.133&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.132&r2=1.133

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.132
retrieving revision 1.133
diff -u -r1.132 -r1.133
--- hb-install-stage.xml	2 Jan 2013 19:06:51 -0000	1.132
+++ hb-install-stage.xml	3 Aug 2013 15:03:03 -0000	1.133
@@ -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.132 2013/01/02 19:06:51 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.133 2013/08/03 15:03:03 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>18</version>
-<date>2012-12-09</date>
+<version>19</version>
+<date>2013-08-03</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -152,10 +152,20 @@
 
 <p>
 Then compare the output of these commands with the value registered in the
-.DIGESTS files that can be found on the mirrors as well. The values need to
+<path>.DIGESTS(.asc)</path>  files that can be found on the mirrors as well. The values need to
 match, otherwise the downloaded file might be corrupt (or the digests file is).
 </p>
 
+<p>
+Just like with the ISO file, you can also verify the cryptographic signature of
+the <path>.DIGESTS.asc</path> file using <c>gpg</c> to make sure the checksums
+have not been tampered with:
+</p>
+
+<pre caption="Validating the checksums using gpg">
+# <i>gpg --verify <keyval id="stage3" />.DIGESTS.asc</i>
+</pre>
+
 </body>
 </subsection>
 <subsection>

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

[Sven Vermeulen (swift)]

swift       13/12/17 10:16:39

  Modified:             hb-install-stage.xml
  Log:
  Improve English (bug #489782)

Revision  Changes    Path
1.134                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.134&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.134&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.133&r2=1.134

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.133
retrieving revision 1.134
diff -u -r1.133 -r1.134
--- hb-install-stage.xml	3 Aug 2013 15:03:03 -0000	1.133
+++ hb-install-stage.xml	17 Dec 2013 10:16:39 -0000	1.134
@@ -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.133 2013/08/03 15:03:03 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.134 2013/12/17 10:16:39 swift Exp $ -->
 
 <sections>
 
@@ -316,7 +316,7 @@
 <p>
 When you define the <c>CFLAGS</c> and <c>CXXFLAGS</c>, you should combine
 several optimization flags. The default values contained in the stage3 archive
-you unpacked should be good enough. The following example is just an example:
+you unpacked should be good enough. The following one is just an example:
 </p>
 
 <pre test="not(contains('AMD64 arm', func:keyval('arch')))" caption="Defining the CFLAGS and CXXFLAGS variable">