scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx 3.x
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Fri, 25 Sep 2020 08:05:40 +0000 (10:05 +0200)
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Thu, 15 Oct 2020 05:49:35 +0000 (07:49 +0200)
commite3ad05fe6e6ff645aa91e9a555231ff53470daba
treeb55cb2029cb924feaa63e619f7ab87ba06d560f5
parentefa44475b8f5c692be4c5822a659e1a96f16dacb
scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx 3.x

Unfortunately, Sphinx 3.x parser for c functions is too pedantic:

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

While it could be relaxed with some configurations, there are
several corner cases that it would make it hard to maintain,
and will require teaching conf.py about several macros.

So, let's instead use the :c:macro notation. This will
produce an output that it is not as nice as currently, but it
should still be acceptable, and will provide cross-references,
removing thousands of warnings when building with newer
versions of Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
scripts/kernel-doc