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
no real details
/usr/share/doc/e16
$ qlist -e enlightenment | grep -c doc/e16/ 0 $ qlist -I -v enlightenment x11-wm/enlightenment-1.0.1
Making install in docs make[1]: Entering directory `/var/tmp/portage/x11-wm/enlightenment-1.0.1/work/e16-1.0.1/docs' make[2]: Entering directory `/var/tmp/portage/x11-wm/enlightenment-1.0.1/work/e16-1.0.1/docs' make[2]: Nothing to be done for `install-exec-am'. test -z "/usr/share/doc/e16" || /bin/mkdir -p "/var/tmp/portage/x11-wm/enlightenment-1.0.1/image//usr/share/doc/e16" test -z "/usr/share/man/man1" || /bin/mkdir -p "/var/tmp/portage/x11-wm/enlightenment-1.0.1/image//usr/share/man/man1" make[2]: Leaving directory `/var/tmp/portage/x11-wm/enlightenment-1.0.1/work/e16-1.0.1/docs' make[1]: Leaving directory `/var/tmp/portage/x11-wm/enlightenment-1.0.1/work/e16-1.0.1/docs' directory is created empty…
the dir is now trimmed in the 1.0.1 ebuild