Re: [PATCH v3 0/8] Improve support for building docs with Sphinx 3.1+

From: Mauro Carvalho Chehab
Date: Fri Sep 25 2020 - 03:32:12 EST


Em Fri, 25 Sep 2020 08:30:38 +0200
Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> escreveu:

> Sphinx 3.x new c domain code broke the doc build on several ways:
>
> - it broke the cdomains.py extension that were giving namespace
> support for C references;
> - it broke the automarkup script;
> - it broke c:type references that kernel-doc and other parts of the
> kernel were using to do cross-references with C declarations.
>
> This series address only part of those issues. It halves the number
> of warnings produced when Spinx 3.x is used. Yet, we still
> have 1.7 K warnings.

At least some of the warnings seem to be due to some issues at
Sphinx 3.x. I opened an issue to Sphinx upstream:

https://github.com/sphinx-doc/sphinx/issues/8241

Thanks,
Mauro