Hi,
While working on a change for Django's documentation, I found I needed a bug fix in the 1.3.4 release and wanted to set needs_sphinx = '1.3.4', however, as the docs say, "needs_sphinx should be set to a 'major.minor' string. Micro or other versions are not supported (Backwards compatibility is
guaranteed between micro releases. There should be no need to require a
specific micro version.)".
I didn't track down the particular bug # of the issue that was fixed, but it's that a link like :option:`commandname --traceback` won't work if the space is a newline.
I wonder if anyone else thinks micro version support for needs_sphinx would be useful? If so, I might try implementing.
On a related note, as noted in a GitHub issue [1], the error message if you specific a micro version is confusing and could at least be fixed:
Running Sphinx v1.3.4
Sphinx version error:
This project needs at least Sphinx v1.3.4 and therefore cannot be built with this version.
make: *** [html] Error 1
[1]
https://github.com/sphinx-doc/sphinx/issues/527Thanks!
Tim