Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-stage.xml hb-install-system.xml
Date: Sat, 08 Dec 2012 21:02:55
Message-Id: 20121208203721.A9A812171D@flycatcher.gentoo.org
1 swift 12/12/08 20:37:21
2
3 Modified: hb-install-stage.xml hb-install-system.xml
4 Log:
5 Using emerge-webrsync as primary method for installing a Portage tree during installation
6
7 Revision Changes Path
8 1.128 xml/htdocs/doc/en/handbook/hb-install-stage.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.128&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.128&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.127&r2=1.128
13
14 Index: hb-install-stage.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
17 retrieving revision 1.127
18 retrieving revision 1.128
19 diff -u -r1.127 -r1.128
20 --- hb-install-stage.xml 8 Dec 2012 18:42:05 -0000 1.127
21 +++ hb-install-stage.xml 8 Dec 2012 20:37:21 -0000 1.128
22 @@ -4,7 +4,7 @@
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-stage.xml,v 1.127 2012/12/08 18:42:05 swift Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.128 2012/12/08 20:37:21 swift Exp $ -->
28
29 <sections>
30
31 @@ -13,7 +13,7 @@
32 describe how you extract the stage3 archive and configure Portage.
33 </abstract>
34
35 -<version>15</version>
36 +<version>16</version>
37 <date>2012-12-08</date>
38
39 <section>
40 @@ -267,59 +267,17 @@
41 <p>
42 You now have to install a Portage snapshot, a collection of files that inform
43 Portage what software titles you can install, which profiles are available, etc.
44 +The contents of this snapshot will be extracted to <path>/usr/portage</path>.
45 </p>
46
47 -</body>
48 -</subsection>
49 -<subsection id="installing_from_Internet">
50 -<title>Download and Install a Portage Snapshot</title>
51 -<body>
52 -
53 -<p>
54 -Go to the mountpoint where you mounted your filesystem (most likely
55 -<path>/mnt/gentoo</path>):
56 -</p>
57 -
58 -<pre caption="Going to the Gentoo mountpoint">
59 -# <i>cd /mnt/gentoo</i>
60 -</pre>
61 -
62 -<p>
63 -Fire up <c>links</c> (or <c>lynx</c>) and go to our <uri
64 -link="/main/en/mirrors.xml">Gentoo mirror list</uri>. Pick a mirror close to
65 -you and open the <path>snapshots/</path> directory. There, download the latest
66 -Portage snapshot (<path>portage-latest.tar.bz2</path>) by selecting it and
67 -pressing <c>D</c>.
68 -</p>
69 -
70 -<pre caption="Browsing the Gentoo mirrorlist">
71 -# <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
72 -</pre>
73 -
74 -<p>
75 -Now exit your browser by pressing <c>Q</c>. You will now have a Portage snapshot
76 -stored in <path>/mnt/gentoo</path>.
77 -</p>
78 -
79 -<p>
80 -If you want to check the integrity of the downloaded snapshot, use
81 -<c>md5sum</c> and compare the output with the MD5 checksum provided on the
82 -mirror.
83 -</p>
84 -
85 -<pre caption="Checking integrity of a Portage snapshot">
86 -# <i>md5sum -c portage-latest.tar.bz2.md5sum</i>
87 -portage-latest.tar.bz2: OK
88 -</pre>
89 -
90 <p>
91 -In the next step, we extract the Portage snapshot onto your filesystem. Make
92 -sure that you use the exact command; the last option is a capital <c>C</c>, not
93 -<c>c</c>.
94 +We recommend the use of <c>emerge-webrsync</c>. This will fetch the latest
95 +portage snapshot (which Gentoo releases on a daily basis) from one of our mirrors
96 +and install it onto your system.
97 </p>
98
99 -<pre caption="Extracting the Portage snapshot">
100 -# <i>tar xvjf /mnt/gentoo/portage-latest.tar.bz2 -C /mnt/gentoo/usr</i>
101 +<pre caption="Running emerge-webrsync to install a Portage snapshot">
102 +~# <i>emerge-webrync</i>
103 </pre>
104
105 </body>
106
107
108
109 1.126 xml/htdocs/doc/en/handbook/hb-install-system.xml
110
111 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.126&view=markup
112 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.126&content-type=text/plain
113 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?r1=1.125&r2=1.126
114
115 Index: hb-install-system.xml
116 ===================================================================
117 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v
118 retrieving revision 1.125
119 retrieving revision 1.126
120 diff -u -r1.125 -r1.126
121 --- hb-install-system.xml 24 Jul 2012 12:12:52 -0000 1.125
122 +++ hb-install-system.xml 8 Dec 2012 20:37:21 -0000 1.126
123 @@ -4,7 +4,7 @@
124 <!-- The content of this document is licensed under the CC-BY-SA license -->
125 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
126
127 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.125 2012/07/24 12:12:52 swift Exp $ -->
128 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.126 2012/12/08 20:37:21 swift Exp $ -->
129
130 <sections>
131
132 @@ -14,8 +14,8 @@
133 to progress to that state.
134 </abstract>
135
136 -<version>17</version>
137 -<date>2012-07-24</date>
138 +<version>18</version>
139 +<date>2012-12-08</date>
140
141 <section>
142 <title>Chrooting</title>
143 @@ -176,12 +176,13 @@
144 <section>
145 <title>Configuring Portage</title>
146 <subsection>
147 -<title>Updating the Portage tree</title>
148 +<title>Optional: Updating the Portage tree</title>
149 <body>
150
151 <p>
152 -You should now update your Portage tree to the latest version. <c>emerge
153 ---sync</c> does this for you.
154 +You can now update your Portage tree to the latest version. <c>emerge
155 +--sync</c> will use the rsync protocol to update the Portage tree (which
156 +you fetched earlier on through <c>emerge-webrsync</c>) to the latest state.
157 </p>
158
159 <pre caption="Updating the Portage tree">
160 @@ -192,9 +193,8 @@
161 </pre>
162
163 <p>
164 -If you are behind a firewall that blocks rsync traffic, you can use
165 -<c>emerge-webrsync</c> which will download and install a portage snapshot for
166 -you.
167 +If you are behind a firewall that blocks rsync traffic, you safely ignore this
168 +step as you already have a quite up-to-date Portage tree.
169 </p>
170
171 <p>