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

[Markus Heiser]

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