Per bug 420151, grub2-probe and grub2-mkconfig require /sys to be mounted. Please modify code listing 1.4 in chapter 6 to include a bind mount of /sys to /mnt/gentoo/sys. http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=6#doc_chap1_sect3
*** This bug has been marked as a duplicate of bug 419607 ***
This bug is about adding a bind mount of /sys to the handbook. This may be done independently of any grub2 documentation. Bind mounting /sys is a good idea in its own right.
it's never been needed before for anything resembling a normal install, which is what the handbooks document. please explain your reasoning.
To be honest, it is just something I do whenever I create a new chroot, since I am not sure what may need to use it. In fact, I was unaware that grub needed it before this bug was filed 3 days ago. So, I guess my argument is that it doesn't hurt and is known to resolve at least one problem (grub2). If you're dead set against it, I'll just leave it alone for now. Side note: what would be the best way to discuss adding grub2 instructions to the handbook?
there's no way we're adding anything related to grub2 to the handbook. it's nowhere near even getting out of hardmask, much less into the stable tree. all grub2 info is best placed (for now) on wiki.gentoo.org...i think there's already a substantial article on it. as you say, this should wait until later, so marking the bug as such. (if i could bring back RESO LATER or RESO REMIND, i would!)
I'm at a loss why we can't just recommend inthe docs that people bond mount /sys. It's not like it breaks existing configurations and it makes the docs more future proof.
telling people to bind mount /sys in their chroot isn't really specific to grub2. more and more tools are relying on it.
Fixed in CVS.