* Suggest using emerge-webrsync instead of downloading a portage snapshot and
unpacking.
* Recommend mounting /sys for grub2 and other bootloader users.
* Remove the unnecessary env-update after entering chroot.
* Add ext4 to filesystems and suggest it as default for /. We can probably remove
jfs and reiserfs from this list to keep it less overwhelming, but thats a debate
for another day.
* Additional net interfaces should be symlinked to net.lo, not net.eth0, as
net.eth0 is itself a symlink to net.lo
---
.../doc/en/gentoo-x86-quickinstall-stage.xml | 50 ++++++++--------------
.../doc/en/gentoo-x86-quickinstall-system.xml | 8 ++--
xml/htdocs/doc/en/gentoo-x86-quickinstall.xml | 18 ++++----
3 files changed, 30 insertions(+), 46 deletions(-)
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
index dd48c41..ccc72ee 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
@@ -4,8 +4,8 @@
<included>
-<version>14</version>
-<date>2012-02-29</date>
+<version>15</version>
+<date>2013-01-16</date>
<section>
<title>Setting Up The Stage</title>
@@ -54,31 +54,6 @@ user 1m2.920s
sys 0m7.530s
</pre>
-<p>
-Install the latest Portage snapshot. Proceed as for the stage3 archive: choose
-a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download
-the latest snapshot and unpack it.
-</p>
-
-<pre caption="Download the latest Portage snapshot">
-livecd gentoo # <i>cd /mnt/gentoo/usr</i>
-livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
-<comment>(Pick a mirror, move to the snapshots/ directory,
-highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment>
-
-<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
-livecd gentoo # <i>cd /mnt/gentoo/usr</i>
-livecd usr # <i>wget http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i>
-</pre>
-
-<pre caption="Unpack the Portage snapshot">
-livecd usr # <i>time tar xjf portage-lat*</i>
-
-real 0m40.523s
-user 0m28.280s
-sys 0m8.240s
-</pre>
-
</body>
</section>
<section>
@@ -86,19 +61,28 @@ sys 0m8.240s
<body>
<p>
-Mount the <path>/proc</path> & <path>/dev</path> file systems, copy over
-the <path>/etc/resolv.conf</path> file, then chroot into your Gentoo
-environment.
+Mount the <path>/proc</path>, <path>/dev</path>, and <path>/sys</path> file
+systems, copy over the <path>/etc/resolv.conf</path> file, then chroot into
+your Gentoo environment.
</p>
<pre caption="Chroot">
livecd usr # <i>cd /</i>
livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i>
livecd / # <i>mount --rbind /dev /mnt/gentoo/dev</i>
-livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
+livecd / # <i>mount --rbind /sys /mnt/gentoo/sys</i>
+livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
livecd / # <i>chroot /mnt/gentoo /bin/bash</i>
-livecd / # <i>env-update && source /etc/profile</i>
->>> Regenerating /etc/ld.so.cache...
+livecd / # <i>source /etc/profile</i>
+</pre>
+
+<p>
+Fetch the latest portage snapshot from the mirrors using emerge-webrsync.
+</p>
+
+<pre caption="Running emerge-webrsync to install a Portage snapshot">
+livecd / # <i>mkdir /usr/portage</i>
+livecd / # <i>emerge webrsync</i>
</pre>
</body>
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
index b4b7e45..34c7b5e 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
@@ -4,8 +4,8 @@
<included>
-<version>7</version>
-<date>2012-03-31</date>
+<version>8</version>
+<date>2013-01-16</date>
<section>
<title>Configure the system</title>
@@ -22,7 +22,7 @@ file systems match your installation.
livecd linux # <i>cd /etc</i>
livecd etc # <i>nano -w fstab</i>
/dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2
-/dev/<i>sda3</i> / ext3 noatime 0 1
+/dev/<i>sda3</i> / ext4 noatime 0 1
/dev/<i>sda2</i> none swap sw 0 0
</pre>
@@ -58,7 +58,7 @@ livecd etc # <i>nano -w fstab</i>
<p>
Configure your network in <path>/etc/conf.d/net</path>. Add the <c>net.eth0</c>
init script to the default run level. If you have multiple NICs, symlink them
-to the <c>net.eth0</c> init script and add them to the default run level as
+to the <c>net.lo</c> init script and add them to the default run level as
well. Don't forget to set your hostname too. Either edit
<path>/etc/conf.d/net</path> and <path>/etc/conf.d/hostname</path> with
<c>nano</c> or use the following commands:
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
index 06200d0..90f010d 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
@@ -29,8 +29,8 @@ want to follow this guide.
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>27</version>
-<date>2012-03-31</date>
+<version>28</version>
+<date>2013-01-16</date>
<chapter>
<title>Introduction</title>
@@ -112,17 +112,17 @@ Units = cylinders of 16065 * 512 = 8225280 bytes
</pre>
<p>
-Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
-<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize your
-swap partition using <c>mkswap</c> and <c>swapon</c>.
+Use <c>mkfs.ext2</c>, <c>mkfs.ext3</c>, <c>mkfs.ext4</c>, <c>mkreiserfs</c>,
+<c>mkfs.xfs</c> and <c>mkfs.jfs</c> to create file systems on your Linux
+partitions. Initialize your swap partition using <c>mkswap</c> and <c>swapon</c>.
</p>
<pre caption="Create the file systems and activate swap">
<comment>(ext2 is all you need on the /boot partition)</comment>
-livecd ~ # <i>mke2fs /dev/sda1</i>
+livecd ~ # <i>mkfs.ext2 /dev/sda1</i>
-<comment>(Let's use ext3 on the main partition)</comment>
-livecd ~ # <i>mke2fs -j /dev/sda3</i>
+<comment>(Let's use ext4 on the main partition)</comment>
+livecd ~ # <i>mkfs.ext4 /dev/sda3</i>
<comment>(Create and activate swap)</comment>
livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i>
@@ -204,7 +204,7 @@ Exit the chrooted environment, unmount all file systems and reboot:
<pre caption="Reboot">
livecd conf.d # <i>exit</i>
livecd / # <i>umount -l /mnt/gentoo/dev{/shm,/pts,}</i>
-livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,}</i>
+livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,/sys,}</i>
livecd / # <i>reboot</i>
<comment>(Don't forget to remove the CD)</comment>
</pre>
--
1.7.12.4
unpacking.
* Recommend mounting /sys for grub2 and other bootloader users.
* Remove the unnecessary env-update after entering chroot.
* Add ext4 to filesystems and suggest it as default for /. We can probably remove
jfs and reiserfs from this list to keep it less overwhelming, but thats a debate
for another day.
* Additional net interfaces should be symlinked to net.lo, not net.eth0, as
net.eth0 is itself a symlink to net.lo
---
.../doc/en/gentoo-x86-quickinstall-stage.xml | 50 ++++++++--------------
.../doc/en/gentoo-x86-quickinstall-system.xml | 8 ++--
xml/htdocs/doc/en/gentoo-x86-quickinstall.xml | 18 ++++----
3 files changed, 30 insertions(+), 46 deletions(-)
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
index dd48c41..ccc72ee 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
@@ -4,8 +4,8 @@
<included>
-<version>14</version>
-<date>2012-02-29</date>
+<version>15</version>
+<date>2013-01-16</date>
<section>
<title>Setting Up The Stage</title>
@@ -54,31 +54,6 @@ user 1m2.920s
sys 0m7.530s
</pre>
-<p>
-Install the latest Portage snapshot. Proceed as for the stage3 archive: choose
-a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download
-the latest snapshot and unpack it.
-</p>
-
-<pre caption="Download the latest Portage snapshot">
-livecd gentoo # <i>cd /mnt/gentoo/usr</i>
-livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
-<comment>(Pick a mirror, move to the snapshots/ directory,
-highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment>
-
-<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
-livecd gentoo # <i>cd /mnt/gentoo/usr</i>
-livecd usr # <i>wget http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i>
-</pre>
-
-<pre caption="Unpack the Portage snapshot">
-livecd usr # <i>time tar xjf portage-lat*</i>
-
-real 0m40.523s
-user 0m28.280s
-sys 0m8.240s
-</pre>
-
</body>
</section>
<section>
@@ -86,19 +61,28 @@ sys 0m8.240s
<body>
<p>
-Mount the <path>/proc</path> & <path>/dev</path> file systems, copy over
-the <path>/etc/resolv.conf</path> file, then chroot into your Gentoo
-environment.
+Mount the <path>/proc</path>, <path>/dev</path>, and <path>/sys</path> file
+systems, copy over the <path>/etc/resolv.conf</path> file, then chroot into
+your Gentoo environment.
</p>
<pre caption="Chroot">
livecd usr # <i>cd /</i>
livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i>
livecd / # <i>mount --rbind /dev /mnt/gentoo/dev</i>
-livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
+livecd / # <i>mount --rbind /sys /mnt/gentoo/sys</i>
+livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
livecd / # <i>chroot /mnt/gentoo /bin/bash</i>
-livecd / # <i>env-update && source /etc/profile</i>
->>> Regenerating /etc/ld.so.cache...
+livecd / # <i>source /etc/profile</i>
+</pre>
+
+<p>
+Fetch the latest portage snapshot from the mirrors using emerge-webrsync.
+</p>
+
+<pre caption="Running emerge-webrsync to install a Portage snapshot">
+livecd / # <i>mkdir /usr/portage</i>
+livecd / # <i>emerge webrsync</i>
</pre>
</body>
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
index b4b7e45..34c7b5e 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
@@ -4,8 +4,8 @@
<included>
-<version>7</version>
-<date>2012-03-31</date>
+<version>8</version>
+<date>2013-01-16</date>
<section>
<title>Configure the system</title>
@@ -22,7 +22,7 @@ file systems match your installation.
livecd linux # <i>cd /etc</i>
livecd etc # <i>nano -w fstab</i>
/dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2
-/dev/<i>sda3</i> / ext3 noatime 0 1
+/dev/<i>sda3</i> / ext4 noatime 0 1
/dev/<i>sda2</i> none swap sw 0 0
</pre>
@@ -58,7 +58,7 @@ livecd etc # <i>nano -w fstab</i>
<p>
Configure your network in <path>/etc/conf.d/net</path>. Add the <c>net.eth0</c>
init script to the default run level. If you have multiple NICs, symlink them
-to the <c>net.eth0</c> init script and add them to the default run level as
+to the <c>net.lo</c> init script and add them to the default run level as
well. Don't forget to set your hostname too. Either edit
<path>/etc/conf.d/net</path> and <path>/etc/conf.d/hostname</path> with
<c>nano</c> or use the following commands:
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
index 06200d0..90f010d 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
@@ -29,8 +29,8 @@ want to follow this guide.
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>27</version>
-<date>2012-03-31</date>
+<version>28</version>
+<date>2013-01-16</date>
<chapter>
<title>Introduction</title>
@@ -112,17 +112,17 @@ Units = cylinders of 16065 * 512 = 8225280 bytes
</pre>
<p>
-Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
-<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize your
-swap partition using <c>mkswap</c> and <c>swapon</c>.
+Use <c>mkfs.ext2</c>, <c>mkfs.ext3</c>, <c>mkfs.ext4</c>, <c>mkreiserfs</c>,
+<c>mkfs.xfs</c> and <c>mkfs.jfs</c> to create file systems on your Linux
+partitions. Initialize your swap partition using <c>mkswap</c> and <c>swapon</c>.
</p>
<pre caption="Create the file systems and activate swap">
<comment>(ext2 is all you need on the /boot partition)</comment>
-livecd ~ # <i>mke2fs /dev/sda1</i>
+livecd ~ # <i>mkfs.ext2 /dev/sda1</i>
-<comment>(Let's use ext3 on the main partition)</comment>
-livecd ~ # <i>mke2fs -j /dev/sda3</i>
+<comment>(Let's use ext4 on the main partition)</comment>
+livecd ~ # <i>mkfs.ext4 /dev/sda3</i>
<comment>(Create and activate swap)</comment>
livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i>
@@ -204,7 +204,7 @@ Exit the chrooted environment, unmount all file systems and reboot:
<pre caption="Reboot">
livecd conf.d # <i>exit</i>
livecd / # <i>umount -l /mnt/gentoo/dev{/shm,/pts,}</i>
-livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,}</i>
+livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,/sys,}</i>
livecd / # <i>reboot</i>
<comment>(Don't forget to remove the CD)</comment>
</pre>
--
1.7.12.4