[arch-releng] [PATCH] Update Documentation to reflect new bootloader installation method

[Dieter Plaetinck]

On Wed,  9 Mar 2011 14:53:32 -0500
pyther at 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