public inbox for gentoo-doc@lists.gentoo.org
 help / color / mirror / Atom feed
From: Daniel Meltzer <dmeltzer.gentoo@gmail.com>
To: gentoo-doc@lists.gentoo.org
Subject: Re: [gentoo-doc] [PATCH 1/3] Bring gentoo-x86-quickinstall in line with many of the changes that have been made to the official handbook.
Date: Thu, 17 Jan 2013 18:08:17 -0500	[thread overview]
Message-ID: <20130117230817.GA18701@Positve> (raw)
In-Reply-To: <CAPzO=Nzt=4DndaAO=Kw2_3d=oQx=tedRMjoRDuQVWbZaSeDw1A@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 434 bytes --]

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.

[-- Attachment #2: 0001-Bring-gentoo-x86-quickinstall-in-line-with-many-of-t.patch --]
[-- Type: text/x-diff, Size: 6859 bytes --]

From 934de9b6a074ebec1a547ff04ef640be439ddc1e Mon Sep 17 00:00:00 2001
Message-Id: <934de9b6a074ebec1a547ff04ef640be439ddc1e.1358463447.git.dmeltzer.gentoo@gmail.com>
From: Daniel Meltzer <parallelgrapefruit@gmail.com>
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


      reply	other threads:[~2013-01-17 23:08 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-01-17  5:04 [gentoo-doc] [PATCH 1/3] 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: Daniel Meltzer
2013-01-17  5:04 ` [gentoo-doc] [PATCH 2/3] Fix minor typo Daniel Meltzer
2013-01-17  5:04 ` [gentoo-doc] [PATCH 3/3] Add selecting a profile, clean up old useflag options in the install kde/gnome section Daniel Meltzer
2013-01-17  6:19 ` [gentoo-doc] [PATCH 1/3] 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: Joshua Saddler
2013-01-17  7:46 ` Sven Vermeulen
2013-01-17 23:08   ` Daniel Meltzer [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20130117230817.GA18701@Positve \
    --to=dmeltzer.gentoo@gmail.com \
    --cc=gentoo-doc@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox