The grub-install command prescribed by the handbook fails because there is no /etc/mtab yet in the chroot'd environment. This can be easily solved by copying /proc/mounts over to /etc/mtab, but newbies might not realize this; therefore, we should put in a note to copy over mtab, or suggest an alternative method for installing grub, that does not rely on mtab.
I think the references to grub-install are now removed from the handbook, after a short test period. There is active discussion about this issue, doc devs are working hard ;) see http://marc.theaimsgroup.com/?l=gentoo-doc&m=108143241409948
See also the bugreport upstream: http://savannah.gnu.org/bugs/?func=detailitem&item_id=8539
Seems to be removed from the handbook now, in favor of the grub shell method. Closing the bug...
I'm reopening. The use of the grub shell is indeed used currently, but it isn't advised. Using grub-install is, but it is currently not possible due to a (go figure) coreutils issue (df to be exact). When coreutils is updated I hope that I can use grub-install in the next installation instructions (2004.2 release).
Sven, can you confirm that df is still broken?
I can't confirm for the moment (I don't have 2004.2 install media at my disposal yet - stupid download limits); I have altered the instructions in our draft handbook to use grub-install, see http://www.gentoo.org/doc/en/handbook/draft/handbook-x86.xml and http://www.gentoo.org/doc/en/handbook/draft/handbook-amd64.xml
Okay, I got grub-install working. I can't use it outside the chroot (since it hard-required /sbin/grub to be available) but copying over "/proc/mounts" to "/etc/mtab" works just fine. I've updated the instructions in the draft handbook for amd64 and x86: http://www.gentoo.org/doc/en/handbook/draft/handbook-amd64.xml http://www.gentoo.org/doc/en/handbook/draft/handbook-x86.xml I will make those official when I get word from the other architectures that I can commit (still need to ask them yet, first some extra testing).
Okies, changes are now official.