Re: [PATCH v2 1/5] docs: cdomain.py: add support for two new Sphinx 3.1+ tags

2020-09-24 Thread Mauro Carvalho Chehab
Em Thu, 24 Sep 2020 10:24:39 -0600 Jonathan Corbet escreveu: > On Thu, 24 Sep 2020 18:21:45 +0200 > Mauro Carvalho Chehab wrote: > > > As part of changing the documentation subsystem to properly > > build with Sphinx 3.1+, add support for two tags: > > > > - :c:expr:`foo` > > - .. c:na

Re: [PATCH v2 1/5] docs: cdomain.py: add support for two new Sphinx 3.1+ tags

2020-09-24 Thread Jonathan Corbet
On Thu, 24 Sep 2020 18:21:45 +0200 Mauro Carvalho Chehab wrote: > As part of changing the documentation subsystem to properly > build with Sphinx 3.1+, add support for two tags: > > - :c:expr:`foo` > - .. c:namespace::" So is there a reason we need :c:expr: ? What does it add for u

[PATCH v2 1/5] docs: cdomain.py: add support for two new Sphinx 3.1+ tags

2020-09-24 Thread Mauro Carvalho Chehab
Since Sphinx 3.0, the C domain code was rewritten, but only after version 3.1 it got support for setting namespaces on C domains, with is something that it is required, in order to document system calls, like ioctl() and others. As part of changing the documentation subsystem to properly build wit