§ 12.3 says at the end:
"However, installing the documentation into the documentation directory
of the main package is preferred since it is independent of the
packaging method and will be easier for users to find."
Now I have in the simplyhtml package
(http://anonscm.debian.org/cgit/pkg-java/simplyhtml.git):
simplyhtml-doc.docs:
build/docs/javadoc/
--> this creates a simplyhtml-doc package like this:
/.
/usr
/usr/share
/usr/share/doc-base
/usr/share/doc-base/simplyhtml-doc
/usr/share/doc
/usr/share/doc/simplyhtml-doc
/usr/share/doc/simplyhtml-doc/copyright
/usr/share/doc/simplyhtml-doc/javadoc
/usr/share/doc/simplyhtml-doc/javadoc/overview-tree.html