On 2020-06-24 01:57, Stephan Lachnit wrote:
-----BEGIN PGP MESSAGE-----
Version: ProtonMail
wcFMAysU9YM04hChAQ//cTKRX2ovcrbEV2oEgObcf8/pwIk/p6l0K7sqm2Im
NHnk1mPaSg1VqIdK+QlqGgomxU/oZDSicnjRI1a7dNRvbJuOvMDKMqacQUIc
zJWXCdOxBw361ut+2LrcbwgaMFcW/fuXPbFFt3k5cWNVv8+qBtSFq/VwsSMs
Heh that's kind of funny if your mail client is automatically encrypting
to me, but not encrypting to the mailing list. Seems to defeat the point
of encrypting... still, we should all be using it more.
It looks like you've added --with sphinxdoc to dh, but haven't actually
triggered the doc build itself (dh --with sphinxdoc doesn't *build* the
docs, it just manages the installation of them, and the value of
${sphinxdoc:Depends})
See the commented part of dh_make's debian/rules. Uncomment to get the
docs building.
Or you can also do it just with cd docs; make html. I'm not sure why
dh_make uses a more complicated method. Maybe not all python modules
provide a docs/Makefile.
Building man pages fails (with either method), but you don't need a
manpage for a python module with no binary executable. HTML is enough.
Note the doc-base file in the dh_make templates. It's nice to use this
to register the docs (cf. file:///usr/share/doc/HTML/index.html)
Drew