Update grub-install documentation.
PATCH 1/1 Update grub-install documentation.
The documentation for grub-install in docs/grub.texi is mostly just a leftover from the GRUB legacy documentation, and is therefore inaccurate in many ways with respect to GRUB2. Attached is a merge proposal that fixes most of the problems I found with the grub-install documentation. One problem that I did find that I don't know quite how to deal with (and haven't in this patch) is this paragraph:
By the way, as noted above, it is quite difficult to guess BIOS drives correctly under a UNIX-like OS. Thus, grub-install will prompt you to check if it could really guess the correct mappings, after the installation. The format is defined in Device map. Please be quite careful. If the output is wrong, it is unlikely that your computer will be able to boot with no problem.
The device.map is not needed in most cases, and GRUB2 for all but a few odd and uncommon cases is completely independent of device enumeration. Despite that, a user can create a device.map that would cause problems with grub-install, for instance "(hd0) /dev/md0". So some mention of device.map with regard to grub-install is probably needed, but I'll leave that to someone else to write.
# Bazaar merge directive format 2 (Bazaar 0.90)
# revision_id: [email protected] # target_branch: file:///home/jordan/grub-bzr/grub-trunk/ # testament_sha1: 672157381054a4b4f1842f87eb01970813e873c2 # timestamp: 2010-09-20 14:06:06 -0700
# base_revision_id: [email protected] #
# Begin patch
=== modified file 'ChangeLog'
ChangeLog +5 -0
@@ -1,3 +1,8 @@ +2010-09-20 Jordan Uggla <[email protected]> + + Update grub-install documetation to account for changes between + GRUB legacy and GRUB2. + 2010-09-20 Vladimir Serbinenko <[email protected]> Make cutmem accept a region specification.
=== modified file 'docs/grub.texi'
grub.texi +19 -33
93 lines not on this page · raw message
# Begin bundle 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