some packages might want to have several html directories. like: /usr/share/doc/foobar-r1/{one,two,three,four}/html
Already there. Use docinto and it works. Might need to install a more recent portage than 1.8.8-r1, however ;)