On Mon, Dec 30, 2024 at 01:22:09PM +0500, Andrey Rakhmatullin wrote: > On Mon, Dec 30, 2024 at 09:10:27AM +0100, Florian Ernst wrote: > > @debian-python: > > > > However, AFAIK intersphinx will download things from the internet during > > build, which is not allowed by policy. So maybe just ripping out all > > intersphinx references from the conf.py would be more suitable. I tested > > that and the resulting files are identical (except for a missing > > reference to intersphinx in the resulting searchindex.js, of course). > > I don't know the current best practices on that with respect to Sphinx, > > hence the CC. > > Yes, we normally patch docs/conf.py to use objects.inv from the -doc > packages.
Ah, right, thanks for the pointer. And when I restrict my codesearch to just files below debian/ as per <https://codesearch.debian.net/search?q=intersphinx_mapping+path%3Adebian%2F&literal=1> then I get sensible patch samples, whereas without that restriction I was overwhelmed by 355 pages of intersphinx_mapping that seemingly still cause downloads during build. So yeah, then my previous patch should rather look like this, I presume: | Index: pyte-0.8.0/docs/conf.py | =================================================================== | --- pyte-0.8.0.orig/docs/conf.py | +++ pyte-0.8.0/docs/conf.py | @@ -176,7 +176,9 @@ else: | htmlhelp_basename = 'pytedoc' | | # Example configuration for intersphinx: refer to the Python standard library. | -intersphinx_mapping = {'http://docs.python.org/': None} | +intersphinx_mapping = { | + 'python': ('/usr/share/doc/python3-doc/html', '/usr/share/doc/python3-doc/html/objects.inv'), | +} | | autodoc_member_order = 'bysource' | todo_include_todos = True I confirmed that the FTBFS will still remain resolved with this. HTH, Flo
signature.asc
Description: PGP signature
