docs: cdomain.py: extend it to handle new Sphinx 3.x tags
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Fri, 25 Sep 2020 11:38:27 +0000 (13:38 +0200)
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Thu, 15 Oct 2020 05:49:37 +0000 (07:49 +0200)
commit95f49490515e50f7ac23c453241503cd9fb4b434
tree9cc6d286eeb538732dcb033dc29e3b363d505a93
parent71e552aebf260239463d348ecb75b972bee0804b
docs: cdomain.py: extend it to handle new Sphinx 3.x tags

While most of the C domain parsing is done via kernel-doc,
some RST files use C domain tags directly.

While several of them can be removed for Sphinx < 3.0, due
to automarkup.py, and several others that could be
converted into kernel-doc markups, changes like that are
time-consuming, and may not fit all cases.

As we already have the cdomain.py for handing backward
compatibility with Sphinx versions below 3.0, let's
make it more complete, in order to cover any usage of the
newer tags outside kernel-doc.

This way, it should be feasible to use the new tags inside
the Kernel tree, without losing backward compatibility.

This should allow fixing the remaining warnings with
the Kernel tags.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Documentation/sphinx/cdomain.py