Re: [PATCH 1/2] 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:22:25 -0600 Jonathan Corbet escreveu: > On Thu, 24 Sep 2020 18:13:54 +0200 > Mauro Carvalho Chehab wrote: > > > > How can this possibly work without a "global namespace" declaration in > > > markup_namespace()? > > > > ... While I'm not a python expert, the namespace

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

2020-09-24 Thread Jonathan Corbet
On Thu, 24 Sep 2020 18:13:54 +0200 Mauro Carvalho Chehab wrote: > > How can this possibly work without a "global namespace" declaration in > > markup_namespace()? > > ... While I'm not a python expert, the namespace variable is global > because it was defined outside the "markup_namespace"

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

2020-09-24 Thread Mauro Carvalho Chehab
Em Thu, 24 Sep 2020 09:43:35 -0600 Jonathan Corbet escreveu: > So I'm just getting into this and trying to understand what's really going > on, but one thing jumped at me: > > On Thu, 24 Sep 2020 13:22:04 +0200 > Mauro Carvalho Chehab wrote: > > > +# Namespace to be prepended to the full name

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

2020-09-24 Thread Jonathan Corbet
So I'm just getting into this and trying to understand what's really going on, but one thing jumped at me: On Thu, 24 Sep 2020 13:22:04 +0200 Mauro Carvalho Chehab wrote: > +# Namespace to be prepended to the full name > +namespace = None > + > +# > +# Handle trivial newer c domain tags that are

[PATCH 1/2] 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