Re: Documentation: build failure with sphinx >= 3.0.0: exception: cannot import name 'c_funcptr_sig_re' from ''

From: Markus Heiser
Date: Wed Aug 12 2020 - 08:44:23 EST

Am 12.08.20 um 10:21 schrieb Markus Heiser:

Am 12.08.20 um 09:30 schrieb Salvatore Bonaccorso:
The problem is actually related to changes happening in Sphinx 3.0.0.
There is the followign issue filled upstream:

'c_funcptr_sig_re' was removed upstream in sphinx v3.0.0b1 and so the
kernel documentation build fails. This is reproducible with a recent
sphinx version (in attached case it is 3.2.0):

$ make PYTHON=python3 xmldocs
   SPHINX  xmldocs --> file:///home/build/linux/Documentation/output/xml
make[2]: Nothing to be done for 'xml'.
Running Sphinx v3.2.0

Extension error:
Could not import extension cdomain (exception: cannot import name 'c_funcptr_sig_re' from '' (/usr/lib/python3/dist-packages/sphinx/domains/
make[1]: *** [Documentation/Makefile:115: xmldocs] Error 2
make: *** [Makefile:1655: xmldocs] Error 2

Distribution reports related to this issue:

As a workaround to make the documentation build again (but known that
parts of the documentation will be broken), we could drop the cdomain


@jon, do you have time to implement a patch?
.. sorry, I'am in a hurry :o

In the linked github issue you find also a patch that fixes a  I tested the patch (shee below) in the linux kernel.

  For me it works.

Sorry, I have to correct:

a Patch needs more work

sphinx-doc has changed the way how domains are implemented [1].

-- Markus --