You're getting this bug because the package in summary installs its documentation (or at least part of it) outside the usual /usr/share/doc/${PF} directory. First, please keep in mind that this bug might not be noticeable for -r0 ebuilds, but it might be for -r1 and later, since if the ebuild has same name and version of the package, for -r0 it might correspond properly. To fix this, if the package uses autotools, recent version (autoconf 2.61+) have two ./configure switches: --docdir and --htmldir to decide where to put the documentation. Older versions might require you override docdir/htmldir or other custom variables during make install. For non-autotooled build systems, good luck, since I cannot tell you how to achieve the proper results, the same holds true with totally broken buildsystems even when based on autotools. Thanks, Diego
That is only for =grub-static-0.96-r1 which installs in /usr/share/doc/grub-static-0.96-r2 and =grub-static-0.97 which installs in /usr/share/doc/grub-static-0.97-r3. Newer stable versions works correct.
If you check the correspondig source packages for the problematic ebuild versions you will find that the directory structure inside is already wrong (see ${WORKDIR}/usr/share/doc/ ).
seems like this has been fixed in newer versions