Created attachment 178230 [details] Sphinx error logfile Django 1.10.4 docs no longer build. Sphinx 1.4.8 fails earlier and at different point then forthcoming 1.5.1 (#215311). Log for Sphinx 1.51 attached. Upstream tag 1.10.4 doesn't have this issue with 1.4.6 Sphinx.
Between working and not working environments version of py35-docutils seems to be the culprit and log also points there. Checking revert of py35-docutils to 0.12_1.
docutils version is a red herring. Cannot see any significant changes in [1]. In theory it should register visit_snippet as per line 61. It is like `snippet_with_filename` is not registered as node at all or delegation is broken.
[1] https://github.com/django/django/blob/master/docs/_ext/djangodocs.py
This is a bug in py-docutils 0.13. Finally narrowed it down by recursively downgrading each dependency to the same version of a working environment. I can't even begin to debug where the real issue is, but as opposed to stated earlier, py-docutils is *NOT* a red herring - but... apparently sphinx is transforming as well to adapt to the new docutils and so as of now, I can say that only Sphinx 1.4.6 and docutils 0.12_1 is a working combination, whereas Sphinx 1.4.6 and docutils 0.13 is not, nor is Sphinx 1.5.1 and docutils 0.12_1. The generated errors shift between versions and have little diagnostic info about the root cause (at least for me not being intimate with docutils and/or sphinx internals). As it is (or at least was a week ago) - the HTMLDOCS option in www/py-django110 is BROKEN and should probably be marked as such.
No takers.