In step 9b (where you are installing the boot loader), the distinction between the MBR and boot partition should be made a little bit sharper. In the sample line where the following command is issued at the Grub prompt: grub> root (hd0,0) (Use information from the boot partition) Can this be changed to: grub> root (hd0,0) (Specify where the /boot partition resides) In my late night rush through this section boot/MBR slurred together. This is especially critical for those of us with dual boot systems where we cannot follow the commands exactly as provided (and run out of sugar/caffeine ;-)). After not being able to boot properly I quit for the night, realizing my mistake as soon as I woke up the next morning. I suspect noobies might pause or experience the same issues if they don't understand the distinction between MBR and boot partitions (and then think they made some horrendous mistake and start the install all over again). Just food for thought. Otherwise I wish other systems were this well documented (and had this level of forum support). Reproducible: Always Steps to Reproduce: 1. No steps, just general comment on one specific aspect of documentation. 2. 3. Actual Results: Once I was fully awake, realized I was specifying the wrong info based on my blurring the use of boot to mean the same thing in all cases :-) I was fine. Expected Results: Possibly add a definition of what a MBR does, what /boot is to linux and what the difference is (one tells hardware where to start looking for bootloaders, other has bootstrap stuff for getting Gentoo going). But more importantly specify '/boot' in documentation/comments/sample code to provide a better distinction (and call attention to) the reference to a disk partition instead of the MBR.
Created attachment 23732 [details, diff] Patch to hb-install-bootloader.xml This patch changes the comment in the Code Listing to what you proposed. I'm a bit afraid that explaining the MBR more than is currently done might lead to confusion for people who's MBR does not hold the job of containing the initial boot sector (some architectures don't need to have this in their MBR). I'll commit this in a few days if I don't hear from you (or you don't mind if I just change the code listing and leave the MBR explanation for what it is).
Your proposal is fine by me -> didn't consider the lack/different use of MBR for some platforms in my original posting. Thanks!
Okay; thanks. I've committed the changes.