swift 12/12/08 20:37:21 Modified: hb-install-stage.xml hb-install-system.xml Log: Using emerge-webrsync as primary method for installing a Portage tree during installation
Revision Changes Path 1.128 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.128&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.128&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.127&r2=1.128 Index: hb-install-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v retrieving revision 1.127 retrieving revision 1.128 diff -u -r1.127 -r1.128 --- hb-install-stage.xml 8 Dec 2012 18:42:05 -0000 1.127 +++ hb-install-stage.xml 8 Dec 2012 20:37:21 -0000 1.128 @@ -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.127 2012/12/08 18:42:05 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.128 2012/12/08 20:37:21 swift Exp $ --> <sections> @@ -13,7 +13,7 @@ describe how you extract the stage3 archive and configure Portage. </abstract> -<version>15</version> +<version>16</version> <date>2012-12-08</date> <section> @@ -267,59 +267,17 @@ <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. +The contents of this snapshot will be extracted to <path>/usr/portage</path>. </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> -Fire up <c>links</c> (or <c>lynx</c>) and go to our <uri -link="/main/en/mirrors.xml">Gentoo mirror list</uri>. Pick a mirror close to -you and open the <path>snapshots/</path> directory. There, download the latest -Portage snapshot (<path>portage-latest.tar.bz2</path>) by selecting it and -pressing <c>D</c>. -</p> - -<pre caption="Browsing the Gentoo mirrorlist"> -# <i>links http://www.gentoo.org/main/en/mirrors.xml</i> -</pre> - -<p> -Now exit your browser by pressing <c>Q</c>. You will now have a Portage snapshot -stored in <path>/mnt/gentoo</path>. -</p> - -<p> -If you want to check the integrity of the downloaded snapshot, use -<c>md5sum</c> and compare the output with the MD5 checksum provided on the -mirror. -</p> - -<pre caption="Checking integrity of a Portage snapshot"> -# <i>md5sum -c portage-latest.tar.bz2.md5sum</i> -portage-latest.tar.bz2: OK -</pre> - <p> -In the next step, we extract the Portage snapshot onto your filesystem. Make -sure that you use the exact command; the last option is a capital <c>C</c>, not -<c>c</c>. +We recommend the use of <c>emerge-webrsync</c>. This will fetch the latest +portage snapshot (which Gentoo releases on a daily basis) from one of our mirrors +and install it onto your system. </p> -<pre caption="Extracting the Portage snapshot"> -# <i>tar xvjf /mnt/gentoo/portage-latest.tar.bz2 -C /mnt/gentoo/usr</i> +<pre caption="Running emerge-webrsync to install a Portage snapshot"> +~# <i>emerge-webrync</i> </pre> </body> 1.126 xml/htdocs/doc/en/handbook/hb-install-system.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.126&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.126&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?r1=1.125&r2=1.126 Index: hb-install-system.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v retrieving revision 1.125 retrieving revision 1.126 diff -u -r1.125 -r1.126 --- hb-install-system.xml 24 Jul 2012 12:12:52 -0000 1.125 +++ hb-install-system.xml 8 Dec 2012 20:37:21 -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-system.xml,v 1.125 2012/07/24 12:12:52 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.126 2012/12/08 20:37:21 swift Exp $ --> <sections> @@ -14,8 +14,8 @@ to progress to that state. </abstract> -<version>17</version> -<date>2012-07-24</date> +<version>18</version> +<date>2012-12-08</date> <section> <title>Chrooting</title> @@ -176,12 +176,13 @@ <section> <title>Configuring Portage</title> <subsection> -<title>Updating the Portage tree</title> +<title>Optional: Updating the Portage tree</title> <body> <p> -You should now update your Portage tree to the latest version. <c>emerge ---sync</c> does this for you. +You can now update your Portage tree to the latest version. <c>emerge +--sync</c> will use the rsync protocol to update the Portage tree (which +you fetched earlier on through <c>emerge-webrsync</c>) to the latest state. </p> <pre caption="Updating the Portage tree"> @@ -192,9 +193,8 @@ </pre> <p> -If you are behind a firewall that blocks rsync traffic, you can use -<c>emerge-webrsync</c> which will download and install a portage snapshot for -you. +If you are behind a firewall that blocks rsync traffic, you safely ignore this +step as you already have a quite up-to-date Portage tree. </p> <p>