[Python-modules-team] Bug#877895: intersphinx plugin makes packages unreproducible

[Dmitry Shachnev]

Hi Antoine!

On Fri, Oct 06, 2017 at 08:59:55PM -0400, Antoine Beaupré wrote:
> I believe that those docs package already do provide docs index, e.g.:
>
> /usr/share/doc/python-configparser/html/objects.inv
>
> it's just a matter of fixing sphinx to make that work then... i wonder
> if interlinks supports file:// paths?

Intersphinx supports local files (the file:// prefix is unneeded). But you
need to explicitly point it to them.

In your package (feed2exec), doc/conf.py currently has:

  intersphinx_mapping = {
      'click': ('http://click.pocoo.org/', None),
      'jinja': ('http://jinja.pocoo.org/docs/', None),
      'python': ('https://docs.python.org/3/', None),
  }

You need to patch this to point to Debian packaged paths. See codesearch [1]
for examples on how others are doing it.

[1]: https://codesearch.debian.net/search?q=html%2Fobjects%5C.inv+path%3Adebian%2Fpatches%2F.*

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20171009/d4867eb8/attachment.sig>