Problem with building docs using sphinx

[mame98]

Details

Building the docs does not work. It worked before, but at some point it stopped working without changing anything. Also, I can build the docs localy using sphinx.

The problem exists since the build # 3768112 (~3 Months ago)

It does not print a clear error message, but the fourth step fails with:

pickling environment... done
checking consistency... done
preparing documents... 

After that there is an endless long Traceback which ends with:

RuntimeError: maximum recursion depth exceeded in cmp

Finaly it does print a 'notification' that it created a full log wich should be submited to the devs of sphinx:

Exception occurred:
  File "/home/docs/checkouts/readthedocs.org/user_builds/side/envs/latest/local/lib/python2.7/site-packages/sphinx/environment.py", line 1965, in traverse_toctree
    traversed.add(docname)
RuntimeError: maximum recursion depth exceeded in cmp
The full traceback has been saved in /tmp/sphinx-err-xmB9lc.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!

I hope that this is enough information for you...

Thanks in advance ;)

If this issue is for a specific project or build, include the following:

• Project: SiDE
• Build #: 3981536

[Aigrefin]

I have exactly the same problem here :
py3njection build #4013767 - failed

[agjohnson]

Does pinning a newer Sphinx release resolve this issue? 1.3.6 or 1.4.1 are good targets

[mame98]

How can I change the sphinx Version?

[blaisep]

@mame98 try editing your requirements.txt to include:
Sphinx==1.3.6

[mame98]

It still fails with the same error but in the log it says Running Sphinx v1.3.6 so 1.3.6 does not fix the problem...

[moorepants]

Same error here: https://readthedocs.org/projects/opty/builds/5513070/

Seems conda pins Sphinx to 1.3.5

[humitos]

Hi! Can you confirm that you still have this issue and provide your project/version/build urls?

Conda shouldn't be pinning packages anymore after #2714

[agjohnson]

Closing due to inactivity.