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.
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
