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

[Matthew Gyurgyik]

On 03/10/2011 02:11 PM, Dieter Plaetinck wrote:
> 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)
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