* [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> & <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
^ permalink raw reply related [flat|nested] 6+ messages in thread
* [gentoo-doc] [PATCH 2/3] Fix minor typo
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 ` 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
` (2 subsequent siblings)
3 siblings, 0 replies; 6+ messages in thread
From: Daniel Meltzer @ 2013-01-17 5:04 UTC (permalink / raw
To: gentoo-doc; +Cc: Daniel Meltzer
---
xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
index ccc72ee..a73e214 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
@@ -82,7 +82,7 @@ Fetch the latest portage snapshot from the mirrors using emerge-webrsync.
<pre caption="Running emerge-webrsync to install a Portage snapshot">
livecd / # <i>mkdir /usr/portage</i>
-livecd / # <i>emerge webrsync</i>
+livecd / # <i>emerge-webrsync</i>
</pre>
</body>
--
1.7.12.4
^ permalink raw reply related [flat|nested] 6+ messages in thread
* [gentoo-doc] [PATCH 3/3] Add selecting a profile, clean up old useflag options in the install kde/gnome section
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 ` 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
3 siblings, 0 replies; 6+ messages in thread
From: Daniel Meltzer @ 2013-01-17 5:04 UTC (permalink / raw
To: gentoo-doc; +Cc: Daniel Meltzer
---
.../en/gentoo-x86-quickinstall-after-reboot.xml | 6 ++--
.../doc/en/gentoo-x86-quickinstall-stage.xml | 35 ++++++++++++++++++++++
2 files changed, 37 insertions(+), 4 deletions(-)
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-after-reboot.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-after-reboot.xml
index 9de2520..2dad931 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-after-reboot.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-after-reboot.xml
@@ -194,8 +194,7 @@ mybox etc # <i>emerge -vp gnome</i>
then edit make.conf if required.</comment>
mybox etc # <i>nano -w /etc/portage/make.conf</i>
<comment>(The following USE flags have been defined)</comment>
-USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
- -kde -qt4 -arts -eds -esd gnome gstreamer gtk firefox"
+USE="-fortran dbus -kde -qt4 -eds "
mybox etc # <i>time emerge gnome</i>
<comment>(326 packages have been emerged)</comment>
@@ -211,8 +210,7 @@ mybox etc # <i>emerge -vp kde-meta</i>
then edit make.conf if required.</comment>
mybox etc # <i>nano -w /etc/portage/make.conf</i>
<comment>The following USE flags have been defined)</comment>
-USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
- kde qt4 -arts -eds -esd -gnome -gstreamer -gtk -firefox"
+USE="-fortran -eds -gnome -gstreamer -gtk -firefox"
mybox etc # <i>time emerge kde-meta</i>
<comment>(391 packages have been emerged)</comment>
diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
index a73e214..15fcabf 100644
--- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
+++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
@@ -109,6 +109,41 @@ Wed Mar 8 00:46:05 CET 2006
</body>
</section>
<section>
+<title>Select your profile</title>
+<body>
+
+<p>
+Choose your profile using eselect. This is an example of the output you might
+see.
+</p>
+
+<pre caption="Verifying System Profile">
+livecd / # <i>eselect profile list</i>
+Available profile symlink targets:
+ [1] default/linux/x86/10.0 *
+ [2] default/linux/x86/10.0/desktop
+ [3] default/linux/x86/10.0/desktop/gnome
+ [4] default/linux/x86/10.0/server
+</pre>
+
+<p>
+Choose the appropriate profile. Keep in mind that default USE flags are
+determined based on the profile you pick.
+</p>
+
+<pre caption="Changing Profile">
+livecd / # <i>eselect profile set 2</i>
+</pre>
+
+<note>
+The <c>developer</c> subprofile is specifically for Gentoo Linux development
+tasks. It is <e>not</e> meant to help you set up your general development
+environments.
+</note>
+
+</body>
+</section>
+<section>
<title>Set your host name and domain name</title>
<body>
--
1.7.12.4
^ permalink raw reply related [flat|nested] 6+ messages in thread
* 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. 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 [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 ` Joshua Saddler
2013-01-17 7:46 ` Sven Vermeulen
3 siblings, 0 replies; 6+ messages in thread
From: Joshua Saddler @ 2013-01-17 6:19 UTC (permalink / raw
To: gentoo-doc
[-- Attachment #1: Type: text/plain, Size: 7608 bytes --]
On Thu, 17 Jan 2013 00:04:11 -0500
Daniel Meltzer <dmeltzer.gentoo@gmail.com> wrote:
> * 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>
most of these are on our to-do list for current/past handbook bugs. thanks for the patches for the quickinstall guide; it's something we've been meaning to do along with the other changes, which have been in the handbook for awhile. hopefully someone'll get to these soonish!
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* 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. 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 [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
` (2 preceding siblings ...)
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
3 siblings, 1 reply; 6+ messages in thread
From: Sven Vermeulen @ 2013-01-17 7:46 UTC (permalink / raw
To: gentoo-doc
[-- Attachment #1: Type: text/plain, Size: 107 bytes --]
Using ext4 as default for / is, while I agree, discussed a few days ago on
the -dev ml iirc and discarded.
[-- Attachment #2: Type: text/html, Size: 124 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* 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.
2013-01-17 7:46 ` Sven Vermeulen
@ 2013-01-17 23:08 ` Daniel Meltzer
0 siblings, 0 replies; 6+ messages in thread
From: Daniel Meltzer @ 2013-01-17 23:08 UTC (permalink / raw
To: gentoo-doc
[-- 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> & <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..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 && 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