Consistent location for library documentation

2017-07-15 Thread Ben Finney
Howdy all, Where is the best location for library documentation of a Debian Python library package? Debian Policy §12.3 says: […] installing the documentation into the documentation directory of the main package is preferred since it is independent of the packaging method and will be

Re: Consistent location for library documentation

2018-03-03 Thread Christopher Hoskin
Dear Ben, Did you get an answer to this? I've just noticed a change in behavior of dh_installdocs between debhelper compat 10 and 11. With compat 10, documents listed in debian/python--doc.docs (e.g. build/html) would get installed to /usr/share/doc/python--doc/ but with compat 11, they get insta

Re: Consistent location for library documentation

2018-03-03 Thread Scott Kitterman
Look at Debian Policy, section 12.3 Additional Documentation. The answer is there. Scott K On Saturday, March 03, 2018 09:25:20 AM Christopher Hoskin wrote: > Dear Ben, > > Did you get an answer to this? > > I've just noticed a change in behavior of dh_installdocs between > debhelper compat 1

Re: Consistent location for library documentation

2018-03-03 Thread Christopher Hoskin
Thanks - so the policy is that the preference is that documentation is installed in /usr/share/doc/, but that /usr/share/doc/-doc is also allowed. The justification is that the documentation is easier for users to find this way. dh_installdocs attempts to compute the name of main package by choppi