Hi Ben and Lance, > Based on the above, I think the issue is that sphinx 1.1 isn't actually > sufficient > to build the documentation.
That is not true. I made some investigation and found that root cause of this issue is the version of python-docutils library. Described issue is a know bug of python-docutils library that was introduced in version 0.8 and fixed in 0.9 [1]. This library is used by sphinx for rST parsing. Bug in their bugtracker: https://sourceforge.net/p/docutils/bugs/182/ Travis uses Ubuntu 12.04 LTS for testing, but it contains[2] buggy python-docutils (0.8.1-4ubuntu1). It's too old. Possible solutions to make Travis happy: * Update python-docutils to at least version 0.9 * Use a workaround for buggy docutils like one suggested in bugtracker: Always use a blank line before the content, i.e. """ .. note:: Some text """ instead of """ .. note:: Some text """ Looks like there was no documentation builds at all before lowering the minimal sphinx version, because Ubuntu 12.04 contains sphinx-1.1.3. My RHEL7 installation has python-sphinx-1.1.3 and python-docutils-0.11 with no build issues. [1] http://docutils.sourceforge.net/HISTORY.html [2] http://packages.ubuntu.com/precise/python-docutils Best regards, Ilya Maximets. _______________________________________________ dev mailing list d...@openvswitch.org https://mail.openvswitch.org/mailman/listinfo/ovs-dev
