Re: [PATCH 1/3] Bring gentoo-x86-quickinstall in line with many of the changes that have been made to the official handbook.

Daniel Meltzer <[email protected]> Thu, 17 Jan 2013 18:08:17 -0500
Newsgroups gmane.linux.gentoo.documentation
Message-ID <20130117230817.GA18701@Positve>
On Thu, Jan 17, 2013 at 08:46:45AM +0100, Sven Vermeulen wrote:
> Using ext4 as default for / is, while I agree, discussed a few days ago on
> the -dev ml iirc and discarded.

Oops! It appears you are correct. For some reason I remembered the
handbook suggesting to use ext4, but I must have imagined it. Attached
is a new version of the patch that just adds ext4 to the list of
suggested file systems, but keeps ext3 as the default.
0001-Bring-gentoo-x86-quickinstall-in-line-with-many-of-t.patch (text/x-diff, 6.7 KB)
From 934de9b6a074ebec1a547ff04ef640be439ddc1e Mon Sep 17 00:00:00 2001
Message-Id: <934de9b6a074ebec1a547ff04ef640be439ddc1e.1358463447.git.dmeltzer.gentoo@gmail.com>
From: Daniel Meltzer <[email protected]>
Date: Wed, 16 Jan 2013 19:36:01 -0500
Subject: [PATCH 1/2] Bring gentoo-x86-quickinstall in line with many of the
 changes that have been made to the official handbook. 
 It would probably make sense down the line to turn this
 into a 64 bit quickinstall guide, as that's rapidly
 becoming the common denominator for new users.  This
 commit makes the following changes:

* 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.  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      |  6 +--
 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml      | 16 +++----
 3 files changed, 28 insertions(+), 44 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..a73e214 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> &amp; <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 &amp;&amp; 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..c5b47ac 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>
@@ -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..7527ad5 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>
+livecd ~ # <i>mkfs.ext3 /dev/sda3</i>
 
 <comment>(Create and activate swap)</comment>
 livecd ~ # <i>mkswap /dev/sda2 &amp;&amp; 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