I'm using Sphinx documentation tool which shows error: "maximum recursion depth exceeded in cmp"

Question

I am using Sphinx documentation tool. While making HTML files using RST files, following error is shown with a hint to solve the error:

Recursion error: maximum recursion depth exceeded in cmp This can happen with very large or deeply nested source files.

You can carefully increase the default Python recursion limit of 1000 in conf.py with Example:

import sys; sys.setrecursionlimit(1500)

I have tried increasing the sys.setrecursionlimit(), but this solution is not working out.

Apart from this, I tried changing the theme for HTML output. But the error remains; regardless of HTML theme.

do you have the full traceback? It is hard to help you without knowing where the error is coming from? — Francesco Montesano
– Francesco Montesano, Commented Jul 17, 2017 at 8:21
@FrancescoMontesano I am not getting full traceback. The system says: build succeeded, 5 warnings. After that above Recursion error is shown. I was looking into Temp folder for full traceback. Do I have to check some where else? — Ankush Shingade
– Ankush Shingade, Commented Jul 17, 2017 at 10:35
I'm sure that you are not going to solve the problem increasing the recursion limit. Usually if you hit this error, there is some bug. Look at the help of sphinx-build there are a few options (e.g. -P, -W that might help) — Francesco Montesano
– Francesco Montesano, Commented Jul 17, 2017 at 13:11

Good Lux · Accepted Answer · 2018-05-16 00:40:13Z

4

I had this same problem, and tried slowly increasing the recursionLimit, which was a waste of time (is started having segmentation faults at ~40300).

What solved the problem for me was editing my index.rst

I had a wildcard in the toctree like this

MyCodeLibrary
##############

.. toctree::
   :glob:

   /*

I fixed it by doing this:

MyCodeLibrary
##############

.. toctree::
   :glob:

   mycodelibrary/*

Hope this helps!

answered May 16, 2018 at 0:40

Good Lux

1,00310 silver badges21 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Cerberton Over a year ago

I attempted to do this, and it yields no results at all, is anyone else encountering this issue? I increased the recursion limit to something like 10000, and addressed the wildcard

Collectives™ on Stack Overflow

I'm using Sphinx documentation tool which shows error: "maximum recursion depth exceeded in cmp"

1 Answer 1

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related