[gentoo-dev] Documentation for sys-boot/grub:2

[Mike Gilbert <floppym@gentoo.org>]

I believe the only thing keeping GRUB 2 masked is a lack of
"documentation". By this, I assume people are referring to the
handbook.

I have created a very minimal "quick start" guide that could be
adapted for the handbook. It relies on the grub2-mkconfig command
auto-detecting most things, which actually works pretty well.

http://wiki.gentoo.org/wiki/GRUB2_Quick_Start

scarabeus created a guide a while back that goes into slightly more detail:

http://dev.gentoo.org/~scarabeus/grub-2-guide.xml

The wiki also has a longer GRUB2 guide. This goes into some of the
more exotic setups. However, some of it is poorly written and I find
editing it quite tedious.

http://wiki.gentoo.org/wiki/GRUB2

So, my question to the community: what level of documentation do we
want to put in the handbook?

If the intent is just to get people up and running on Gentoo, I think
adapting the quick start guide from the wiki is enough. grub2.info has
a very detailed reference; I think we can refer people to that for
manual/advanced configuration.

Is there any other issue with grub:2 that would keep me from unmasking
(adding keywords) on x86 and amd64? I plan on waiting for the 2.00
release.