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
Version 0.9.2: not affected. Version 0.9.2_p48: was affected, fixed with patch. Versions >= 0.10: these install docs in /usr/share/doc/${PN}. Since package is not slotted I don't think this is an issue. Please reopen if it is but keep in mind that these versions switched to cmake for building and I don't know how to manage those. ebuilds rely on cmake-utils eclass for building, so maybe it's the eclass that would need to be fixed, not the ebuild. I don't know.
${PN} is still not good… please do fix it (I doubt it's cmake-utils related but I don't know that eclass well).
Since I was not capable of fixing the build system to install documentation in /usr/share/doc/${PF}, I just fixed it from the outside, after cmake 'make install' equivalent and before filesystem merge. Did it for every package version still affected by this bug.