Re: Policy 12.3 + <pkg>.docs

[Jakub Wilk <jwilk@debian.org>]

* Felix Natter <fnatter@gmx.net>, 2016-04-15, 17:18:
> § 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
[...]

What I usually did in my packages is to ship symlink from 
/usr/share/doc/foo/bar to /usr/share/doc/foo-doc/bar in the foo-doc 
package.

Alternatively, you could use foo-doc.install, instead of foo-doc.docs, 
which allows you to specify destination directory.

--
Jakub Wilk