public inbox for gentoo-doc@lists.gentoo.org
 help / color / mirror / Atom feed
* [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:
@ 2013-01-17  5:04 Daniel Meltzer
  2013-01-17  5:04 ` [gentoo-doc] [PATCH 2/3] Fix minor typo Daniel Meltzer
                   ` (3 more replies)
  0 siblings, 4 replies; 6+ messages in thread
From: Daniel Meltzer @ 2013-01-17  5:04 UTC (permalink / raw
  To: gentoo-doc; +Cc: Daniel Meltzer

* 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> &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..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 &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



^ permalink raw reply related	[flat|nested] 6+ messages in thread
end of thread, other threads:[~2013-01-17 23:08 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
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   ` [gentoo-doc] [PATCH 1/3] Bring gentoo-x86-quickinstall in line with many of the changes that have been made to the official handbook Daniel Meltzer

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox