[klez]

> When I encounter an issue with grub-install not writing to my EFI system partition, good luck finding much about it in its very short man page

This says more about the man pages for grub2 (and grub2 itself, to be honest) EDIT: than about manpages /EDIT.

Compare them with the man pages for grub1. There's a sea of difference.

If you really want to be blown away by a manpage, look for the one for mplayer, which is difficult to find information in for different reasons, i.e., lots of options and lots of options and flags that depend on other flags and options.