GRUB documentation in Gentoo Handbook

[Yoshinori K. Okuji]

Hello,

[Cc: to address@hidden

I am the official maintainer of GNU GRUB, and I'd like to talk about the 
handbook on www.gentoo.org. In this page:

http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=9

you give information on how to make use of GRUB. But I see some 
important problems there.

One of them is that it has no pointer to the official site of GNU GRUB, 
the GRUB manual or the GRUB FAQ. We see many Gentoo users asking 
questions without reading the manual, and I'm personally wondering if 
this can be solved if you put some links to more detailed information 
and encourage users to read the manual before asking. Here are the 
resources:

http://www.gnu.org/software/grub/grub.html 
http://www.gnu.org/software/grub/grub-faq.html 
http://www.gnu.org/software/grub/manual/

Another problem is that it recommends using the grub shell directly 
rather than grub-install. As written in the manual, we cannot recommend 
this, because it can produce bad consequences due to disk cache 
problems in Linux. We have implemented many workarounds in the script 
grub-install, and we hope you will utilize them to overcome 
difficulties in installing a boot loader.

If you don't want to use grub-install for some reason, please implement 
the same workarounds in the handbook or your own script. Otherwise, we 
get many bug reports about problems that we have already solved with a 
lot of effort.

Since Gentoo is a volunteer-based project as well as GRUB, I bet that 
you could understand my point, and we would be able to help each other. 
If you have any question or problem, feel free to send e-mail to 
<address@hidden>.

Thanks,
Okuji