[arch-releng] [PATCH] Update Documentation to reflect new bootloader installation method
--- doc/official_installation_guide_en | 39 ++++++++++++++++++++--------------- 1 files changed, 22 insertions(+), 17 deletions(-) diff --git a/doc/official_installation_guide_en b/doc/official_installation_guide_en index d73ed8e..69578f2 100644 --- a/doc/official_installation_guide_en +++ b/doc/official_installation_guide_en @@ -180,11 +180,9 @@ Make sure your BIOS is set in a way to allow booting from your CD-ROM or USB device. Reboot your computer with the Arch Linux Installation CD in the drive or the USB stick plugged in the port. Once the installation medium has started -booting you will see the Arch Linux logo and a grub menu waiting for your +booting you will see the Arch Linux logo and an Isolinux menu waiting for your selection. Most likely you can just hit enter at this point. -If Grub hangs, you're one of the unlucky few whose CD-rom drive doesn't work -with grub and you should try the isolinux image. ### Post-boot At the end of the boot procedure, you should be at a login prompt with some @@ -460,7 +458,9 @@ hard disk preparations need to be undone. #### Select Packages Select Packages will let you select the packages you wish to install from the -CD, USB or your NET mirror. You have the opportunity to specify whole package +CD, USB or your NET mirror. First, you are prompted to select a bootloader. Your +choice will install the appropriate bootloader package and will be used for the +"Install Bootloader" stage. You now have the opportunity to specify whole package groups from which you'd generally like to install packages, then fine-tune your coarse selection by (de)selecting individual packages from the groups you have chosen using the space bar. It is recommended that you install all the @@ -771,25 +771,30 @@ changes you made in mkinitcpio.conf. #### Install Bootloader -Install Bootloader will install a bootloader on your hard drive, either GRUB -or NONE in case you have a bootloader already installed and want to use that -one instead. If you choose to install GRUB, the setup script will want you to +Install Bootloader will install the bootloader that you selected in the "Select +Source" stage on your hard drive. If you skipped selecting a bootloader, no +bootloader will be installed. Otherwise, the setup script will want you to examine the appropriate configuration file to confirm the proper settings. - **/boot/grub/menu.lst** +**/boot/syslinux/syslinux.cfg** + +An editor will open, allowing you to edit the appropriate bootloader +configuration file. You should check and modify this file to accommodate your +boot setup. The installer will have pre-populated this file using UUID entries +which you may have to change in the same cases you'd need to change them in your +fstab. + +Syslinux: +After checking your bootloader configuration for correctness, you'll be asked to +allow the installer to Set the Boot Flag and install the Syslinux MBR. -You should check and modify this file to accommodate your boot setup if you -want to use GRUB, otherwise you will have to modify your existing bootloader's -configuration file. The installer will have pre-populated this file using UUID -entries which you may have to change in the same cases you'd need to change -them in your fstab. +Grub: After checking your bootloader configuration for correctness, you'll be -prompted for a partition to install the loader to. Unless you're using yet -another boot loader, you should install GRUB to the MBR of the installation -disk, which is usually represented by the appropriate device name without a -number suffix. +prompted for a disk to install the loader to. You should install GRUB to the MBR +of the installation disk, which is usually represented by the appropriate device +name without a number suffix. #### Exit Install -- 1.7.4.1
On Wed, 9 Mar 2011 14:53:32 -0500 pyther@pyther.net wrote:
--- doc/official_installation_guide_en | 39 ++++++++++++++++++++--------------- 1 files changed, 22 insertions(+), 17 deletions(-)
diff --git a/doc/official_installation_guide_en b/doc/official_installation_guide_en index d73ed8e..69578f2 100644 --- a/doc/official_installation_guide_en +++ b/doc/official_installation_guide_en @@ -180,11 +180,9 @@ Make sure your BIOS is set in a way to allow booting from your CD-ROM or USB device. Reboot your computer with the Arch Linux Installation CD in the drive or the USB stick plugged in the port. Once the installation medium has started -booting you will see the Arch Linux logo and a grub menu waiting for your +booting you will see the Arch Linux logo and an Isolinux menu waiting for your selection. Most likely you can just hit enter at this point. -If Grub hangs, you're one of the unlucky few whose CD-rom drive doesn't work -with grub and you should try the isolinux image.
these two changes have nothing to do with the newly introduced syslinux support. these belong in a seprate bugfix commit (where the bug is that this should have been added when we switched to syslinux in archiso)
### Post-boot At the end of the boot procedure, you should be at a login prompt with some @@ -460,7 +458,9 @@ hard disk preparations need to be undone. #### Select Packages
Select Packages will let you select the packages you wish to install from the -CD, USB or your NET mirror. You have the opportunity to specify whole package +CD, USB or your NET mirror. First, you are prompted to select a bootloader. Your +choice will install the appropriate bootloader package and will be used for the +"Install Bootloader" stage. You now have the opportunity to specify whole package groups from which you'd generally like to install packages, then fine-tune your coarse selection by (de)selecting individual packages from the groups you have chosen using the space bar. It is recommended that you install all the @@ -771,25 +771,30 @@ changes you made in mkinitcpio.conf.
"Your choice will install a package" is not very well phrased. How about: "First, you are prompted to select a bootloader package. (this is the bootloader you will be configuring later on in the "Install Bootloader" stage). After this you can select package groups from which (...)"
#### Install Bootloader
-Install Bootloader will install a bootloader on your hard drive, either GRUB -or NONE in case you have a bootloader already installed and want to use that -one instead. If you choose to install GRUB, the setup script will want you to +Install Bootloader will install
how about "install and help you configure" ?
the bootloader that you selected in the "Select +Source"
Not "Select source". "Select packages".
+stage on your hard drive. If you skipped selecting a bootloader, no +bootloader will be installed. Otherwise, the setup script will want you to examine the appropriate configuration file to confirm the proper settings.
- **/boot/grub/menu.lst** +**/boot/syslinux/syslinux.cfg** + +An editor will open, allowing you to edit the appropriate bootloader +configuration file. You should check and modify this file to accommodate your +boot setup. The installer will have pre-populated this file using UUID entries I would leave out the 'using UUID entries'. depending on the filesystem selection method used, this can also be regular devicefiles or by label, just don't mention it imho.
+which you may have to change in the same cases you'd need to change them in your +fstab.
how about "may have to change if you also needed to make changes to your fstab"
+ +Syslinux: +After checking your bootloader configuration for correctness, you'll be asked to +allow the installer to Set the Boot Flag and install the Syslinux MBR.
-You should check and modify this file to accommodate your boot setup if you -want to use GRUB, otherwise you will have to modify your existing bootloader's -configuration file. The installer will have pre-populated this file using UUID -entries which you may have to change in the same cases you'd need to change -them in your fstab. +Grub:
After checking your bootloader configuration for correctness, you'll be -prompted for a partition to install the loader to. Unless you're using yet -another boot loader, you should install GRUB to the MBR of the installation -disk, which is usually represented by the appropriate device name without a -number suffix. +prompted for a disk to install the loader to. You should install GRUB to the MBR +of the installation disk, which is usually represented by the appropriate device +name without a number suffix.
meh, I don't think this is the right place to educate the user on the difference between devicefiles for disks and for partitions. I would leave out the "which is..." part. Dieter
On 03/10/2011 02:11 PM, Dieter Plaetinck wrote:
--- doc/official_installation_guide_en | 39 ++++++++++++++++++++--------------- 1 files changed, 22 insertions(+), 17 deletions(-)
diff --git a/doc/official_installation_guide_en b/doc/official_installation_guide_en index d73ed8e..69578f2 100644 --- a/doc/official_installation_guide_en +++ b/doc/official_installation_guide_en @@ -180,11 +180,9 @@ Make sure your BIOS is set in a way to allow booting from your CD-ROM or USB device. Reboot your computer with the Arch Linux Installation CD in the drive or the USB stick plugged in the port. Once the installation medium has started -booting you will see the Arch Linux logo and a grub menu waiting for your +booting you will see the Arch Linux logo and an Isolinux menu waiting for your selection. Most likely you can just hit enter at this point. -If Grub hangs, you're one of the unlucky few whose CD-rom drive doesn't work -with grub and you should try the isolinux image.
On Wed, 9 Mar 2011 14:53:32 -0500 pyther@pyther.net wrote: these two changes have nothing to do with the newly introduced syslinux support. these belong in a seprate bugfix commit (where the bug is that this should have been added when we switched to syslinux in archiso) It shall go into a new patch
### Post-boot At the end of the boot procedure, you should be at a login prompt with some @@ -460,7 +458,9 @@ hard disk preparations need to be undone. #### Select Packages
Select Packages will let you select the packages you wish to install from the -CD, USB or your NET mirror. You have the opportunity to specify whole package +CD, USB or your NET mirror. First, you are prompted to select a bootloader. Your +choice will install the appropriate bootloader package and will be used for the +"Install Bootloader" stage. You now have the opportunity to specify whole package groups from which you'd generally like to install packages, then fine-tune your coarse selection by (de)selecting individual packages from the groups you have chosen using the space bar. It is recommended that you install all the @@ -771,25 +771,30 @@ changes you made in mkinitcpio.conf.
"Your choice will install a package" is not very well phrased.
How about: "First, you are prompted to select a bootloader package. (this is the bootloader you will be configuring later on in the "Install Bootloader" stage). After this you can select package groups from which (...)"
First, you are prompted to select a bootloader package (the bootloader will be configured later on in the "Install Bootloader" stage). After this, you can select package groups from which you'd generally....
#### Install Bootloader
-Install Bootloader will install a bootloader on your hard drive, either GRUB -or NONE in case you have a bootloader already installed and want to use that -one instead. If you choose to install GRUB, the setup script will want you to +Install Bootloader will install
how about "install and help you configure" ?
the bootloader that you selected in the "Select +Source" Not "Select source". "Select packages".
Install Bootloader will install and help you configure the bootloader that you selected in the "Select Packages" stage. The installer will have you edit the appropriate configuration file to confirm the proper settings.
+stage on your hard drive. If you skipped selecting a bootloader, no +bootloader will be installed. Otherwise, the setup script will want you to examine the appropriate configuration file to confirm the proper settings.
- **/boot/grub/menu.lst** +**/boot/syslinux/syslinux.cfg** + +An editor will open, allowing you to edit the appropriate bootloader +configuration file. You should check and modify this file to accommodate your +boot setup. The installer will have pre-populated this file using UUID entries I would leave out the 'using UUID entries'. depending on the filesystem selection method used, this can also be regular devicefiles or by label, just don't mention it imho.
+which you may have to change in the same cases you'd need to change them in your +fstab. how about "may have to change if you also needed to make changes to your fstab" How about leaving that line out altogether? If you remove 'using UUID entries' that sentences no longer makes any sense.
An editor will open, allowing you to edit the appropriate bootloader configuration file which the installer has pre-populated. You should check and modify this file to accommodate your boot setup.
+ +Syslinux: +After checking your bootloader configuration for correctness, you'll be asked to +allow the installer to Set the Boot Flag and install the Syslinux MBR.
-You should check and modify this file to accommodate your boot setup if you -want to use GRUB, otherwise you will have to modify your existing bootloader's -configuration file. The installer will have pre-populated this file using UUID -entries which you may have to change in the same cases you'd need to change -them in your fstab. +Grub:
After checking your bootloader configuration for correctness, you'll be -prompted for a partition to install the loader to. Unless you're using yet -another boot loader, you should install GRUB to the MBR of the installation -disk, which is usually represented by the appropriate device name without a -number suffix. +prompted for a disk to install the loader to. You should install GRUB to the MBR +of the installation disk, which is usually represented by the appropriate device +name without a number suffix. meh, I don't think this is the right place to educate the user on the difference between devicefiles for disks and for partitions. I would leave out the "which is..." part. I removed it. Note I did not add this (was in the original) Dieter
On Sun, 13 Mar 2011 12:55:54 -0400 Matthew Gyurgyik <pyther@pyther.net> wrote:
+which you may have to change in the same cases you'd need to change them in your +fstab. how about "may have to change if you also needed to make changes to your fstab" How about leaving that line out altogether? If you remove 'using UUID entries' that sentences no longer makes any sense.
An editor will open, allowing you to edit the appropriate bootloader configuration file which the installer has pre-populated. You should check and modify this file to accommodate your boot setup.
ok, but "modify.. , if needed."
participants (3)
-
Dieter Plaetinck
-
Matthew Gyurgyik
-
pyther＠pyther.net