| Summary: | dev-python/docutils-0.9: rst2man.py fails with NotImplementedError when generating llvm docs | ||
|---|---|---|---|
| Product: | Gentoo Linux | Reporter: | Michał Górny <mgorny> |
| Component: | Current packages | Assignee: | Python Gentoo Team <python> |
| Status: | RESOLVED OBSOLETE | ||
| Severity: | normal | Keywords: | REGRESSION |
| Priority: | Normal | ||
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Package list: | Runtime testing required: | --- | |
| Bug Depends on: | |||
| Bug Blocks: | 415295 | ||
| Attachments: | One of the failing files | ||
Created attachment 311769 [details]
One of the failing files
Bug 415295 comment 6 says that docutils-0.8.1 works fine. Just documenting that here. llvm >= 3.2 uses sphinx for doc generation, and faulty docutils versions were removed from tree some time ago, so I am cleaning this bug |
The LLVM project manpages are written in rst. Recently, I added the support for generating them using rst2man.py to the ebuild. While the code worked (with a few warnings about unknown '.. code-block:: perl'), docutils-0.9 fails terribly with the following traceback: $ rst2man.py bugpoint.rst --traceback Traceback (most recent call last): File "/usr/bin/rst2man.py-2.7", line 26, in <module> publish_cmdline(writer=manpage.Writer(), description=description) File "/usr/lib64/python2.7/site-packages/docutils/core.py", line 356, in publish_cmdline config_section=config_section, enable_exit_status=enable_exit_status) File "/usr/lib64/python2.7/site-packages/docutils/core.py", line 223, in publish output = self.writer.write(self.document, self.destination) File "/usr/lib64/python2.7/site-packages/docutils/writers/__init__.py", line 77, in write self.translate() File "/usr/lib64/python2.7/site-packages/docutils/writers/manpage.py", line 106, in translate self.document.walkabout(visitor) File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 173, in walkabout if child.walkabout(visitor): File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 173, in walkabout if child.walkabout(visitor): File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 173, in walkabout if child.walkabout(visitor): File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 173, in walkabout if child.walkabout(visitor): File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 165, in walkabout visitor.dispatch_visit(self) File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 1611, in dispatch_visit return method(node) File "/usr/lib64/python2.7/site-packages/docutils/nodes.py", line 1636, in unknown_visit % (self.__class__, node.__class__.__name__)) NotImplementedError: docutils.writers.manpage.Translator visiting unknown node type: inline The issue can be easily reproduced by emerging =sys-devel/llvm-9999. I've modified the build so that docgen happens (and fails) before the actual compiling starts.