[Django] #29371: Documentation building fails with AssertionError while writing internals/contributing/triaging-tickets
Django
internals/contributing/triaging-tickets
--------------------------------------------+------------------------
Reporter: Giovanni Mariani | Owner: nobody
Type: Bug | Status: new
Component: Uncategorized | Version: 2.0
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
--------------------------------------------+------------------------
Trying to package Django for Rosa Linux Fresh R10 (a Mandriva derivative),
using sphinx 1.4.9.
The build of Django docs ("make -C docs/ html") fails while writing
internals/contributing/triaging-tickets whit this error message:
Exception occurred:
File "/usr/lib/python2.7/site-packages/docutils/writers/_html_base.py",
line 735, in depart_document assert not self.context, 'len(context) = %s'
% len(self.context)
AssertionError: len(context) = 1
The issue is present in 1.8.19 and 1.11.12, with python 2.7, as well in
2.0.4, with python 3.5.
Attached full log of a 1.11.2 failed build and corresponding sphinx
traceback.
--
Ticket URL: <https://code.djangoproject.com/ticket/29371>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
internals/contributing/triaging-tickets
Reporter: Giovanni Mariani | Owner: nobody
Type: Bug | Status: new
Component: Uncategorized | Version: 2.0
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Giovanni Mariani):
* Attachment "sphinx-err-5NNKYX.log" added.
Trace back of a failed build from sphinx
Django
internals/contributing/triaging-tickets
Reporter: Giovanni Mariani | Owner: nobody
Type: Bug | Status: new
Component: Uncategorized | Version: 2.0
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Giovanni Mariani):
* Attachment "DocBuildFailed.log" added.
Edited build log of a failed build
Django
internals/contributing/triaging-tickets
Reporter: Giovanni Mariani | Owner: nobody
Type: Bug | Status: new
Component: Uncategorized | Version: 2.0
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Claude Paroz):
My suspicion while reading the error log is that Sphinx is choking on the
documentation example headers in the `writing-documentation.txt` content.
Did you try with another Sphinx version? I don't remember having been
faced with such an error (I'm using Sphinx 1.7.0 currently).
--
Ticket URL: <https://code.djangoproject.com/ticket/29371#comment:1>
Django
internals/contributing/triaging-tickets
Reporter: Giovanni Mariani | Owner: nobody
Component: Documentation | Version: 2.0
Severity: Normal | Resolution: wontfix
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Tim Graham):
* status: new => closed
* component: Uncategorized => Documentation
* resolution: => wontfix
Comment:
I don't think we'll spend any time to fix issues with older sphinx
versions. The issue seems fixed as of sphinx 1.5.1.
--
Ticket URL: <https://code.djangoproject.com/ticket/29371#comment:2>