Author terry.reedy
Recipients docs@python, eric.araujo, ezio.melotti, georg.brandl, martin.panter, python-dev, terry.reedy, vstinner, zach.ware
Date 2016-08-25.19:34:25
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1472153665.66.0.656564900238.issue26638@psf.upfronthosting.co.za>
In-reply-to
Content
Thank you, that worked -- and should have been documented in the help output.  All the sphinx dependencies were inequalities, and rebuilding worked.

The devguide only says "You are expected to have installed a recent version of Sphinx on your system or in a virtualenv,".  Could we add

"We currently recommend 'python -m pip install sphinx==1.3.6' as the easiest way to install and the best version for most people to install.  See https://bugs.python.org/issue26638 for why."

(I am assuming that pip works on all systems, not just Windows.)  The sentence finishes with "so that the Makefile can find the sphinx-build command."  On Windows. this is most easily done by installing Sphinx with a Python version that was added to PATH when installed.
History
Date User Action Args
2016-08-25 19:34:25terry.reedysetrecipients: + terry.reedy, georg.brandl, vstinner, ezio.melotti, eric.araujo, docs@python, python-dev, martin.panter, zach.ware
2016-08-25 19:34:25terry.reedysetmessageid: <1472153665.66.0.656564900238.issue26638@psf.upfronthosting.co.za>
2016-08-25 19:34:25terry.reedylinkissue26638 messages
2016-08-25 19:34:25terry.reedycreate