Random Sphinx documentation failures

[kerberizer]

trafficstars

Sometimes, the build might fail when making the Sphinx documentation with errors like this...

Exception occurred:
  File "/usr/lib/python3.4/site-packages/sphinx/environment.py", line 1274, in get_doctree
    doctree = pickle.load(f)
EOFError: Ran out of input
The full traceback has been saved in /tmp/sphinx-err-w15t70z0.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
docs/CMakeFiles/docs-llvm-html.dir/build.make:57: recipe for target 'docs/CMakeFiles/docs-llvm-html' failed
make[2]: *** [docs/CMakeFiles/docs-llvm-html] Error 1
CMakeFiles/Makefile2:51010: recipe for target 'docs/CMakeFiles/docs-llvm-html.dir/all' failed
make[1]: *** [docs/CMakeFiles/docs-llvm-html.dir/all] Error 2
make[1]: *** Waiting for unfinished jobs....

At present, it is unknown how and if the bug can be reliably reproduced, nor what's causing it (note to self: could it be because of incompatible Python versions?)

[kerberizer]

NB: 7eda367f5744f5dfc55d45ed4d09fc436a0f16e8 fixed the required python-sphinx package: the original PKGBUILD listed the python3 version as a dependency.

[kerberizer]

The bug hasn't shown up for a long time since the Python dependency was fixed, so I'm going to assume that it's gone for good.

[kode54]

This bug shows up in a different way if you already have the python3 sphinx package installed: It will use that instead, and while it works, it requires the python-recommonmark package to be installed to work. Apparently, I already had all the other necessary Python 3 packages installed.

[kerberizer]

@kode54 Thank you very much for your report. I'll have a look into it.