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
Attachment:
signature.asc
Description: PGP signature