[Skiboot] [PATCH] doc/requirements.txt: pin docutils at 0.14

Stewart Smith stewart at linux.ibm.com
Mon Jul 22 15:10:42 AEST 2019


docutils is a dependency for sphinx. The recently released 0.15 version
throws a syntax error like so:

+ cd doc
+ make html
sphinx-build -b html -d _build/doctrees   . _build/html
Traceback (most recent call last):
  File "/usr/bin/sphinx-build", line 6, in <module>
    from sphinx.cmd.build import main
  File "/usr/lib64/python2.7/site-packages/sphinx/cmd/build.py", line 20, in <module>
    from docutils.utils import SystemMessage
  File "/usr/lib/python2.7/site-packages/docutils/utils/__init__.py", line 21, in <module>
    import docutils.io
  File "/usr/lib/python2.7/site-packages/docutils/io.py", line 348
    (self.destination.mode, mode)), file=self._stderr)
                                        ^
SyntaxError: invalid syntax
make: *** [Makefile:53: html] Error 1

obviously, this isn't ideal - so let's pin our version to one that
actually works.

Signed-off-by: Stewart Smith <stewart at linux.ibm.com>
---
 doc/requirements.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/requirements.txt b/doc/requirements.txt
index 085b3a792a7b..2ad884926534 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -1,2 +1,4 @@
 sphinx
 recommonmark
+# docutils 0.15 has a syntax error. fun.
+docutils == 0.14
-- 
2.21.0



More information about the Skiboot mailing list