Messages in this thread | | | Subject | Re: Documentation: build failure with sphinx >= 3.0.0: exception: cannot import name 'c_funcptr_sig_re' from 'sphinx.domains.c' | From | Markus Heiser <> | Date | Wed, 12 Aug 2020 14:44:13 +0200 |
| |
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: >>> >>> https://github.com/sphinx-doc/sphinx/issues/7421 >>> >>> '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 'sphinx.domains.c' >>> (/usr/lib/python3/dist-packages/sphinx/domains/c.py)) >>> make[1]: *** [Documentation/Makefile:115: xmldocs] Error 2 >>> make: *** [Makefile:1655: xmldocs] Error 2 >>> >>> Distribution reports related to this issue: >>> https://bugs.debian.org/963636 >>> https://bugs.archlinux.org/task/66178 >>> https://bugs.archlinux.org/task/66156 >> >> As a workaround to make the documentation build again (but known that >> parts of the documentation will be broken), we could drop the cdomain >> extension. >> >> Regards, >> Salvatore > > @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 > cdomain.py. 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 --
[1] https://github.com/sphinx-doc/sphinx/commit/0f49e30c
| |