Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-12 Thread Mauro Carvalho Chehab
Em Tue, 6 Oct 2020 08:01:34 -0600 Jonathan Corbet escreveu: > On Tue, 6 Oct 2020 08:42:07 +0200 > Mauro Carvalho Chehab wrote: > > > As right now we don't support Sphinx version 3.0[1], we're actually using > > just > > $sphinx_major. So, I'm wonder if it would make sense to also make > > opt

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-06 Thread Joe Perches
On Tue, 2020-10-06 at 08:01 -0600, Jonathan Corbet wrote: > On Tue, 6 Oct 2020 08:42:07 +0200 > Mauro Carvalho Chehab wrote: > > > As right now we don't support Sphinx version 3.0[1], we're actually using > > just > > $sphinx_major. So, I'm wonder if it would make sense to also make > > optiona

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-06 Thread Jonathan Corbet
On Tue, 6 Oct 2020 08:42:07 +0200 Mauro Carvalho Chehab wrote: > As right now we don't support Sphinx version 3.0[1], we're actually using just > $sphinx_major. So, I'm wonder if it would make sense to also make > optional. Maybe...someday we may need it, knowing how the Sphinx folks approach c

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-06 Thread Joe Perches
On Tue, 2020-10-06 at 08:42 +0200, Mauro Carvalho Chehab wrote: > Em Mon, 5 Oct 2020 10:17:36 -0600 > Jonathan Corbet escreveu: [] > Sure. It should be easy to make the third argument optional, although > the regex will be a little more harder to understand. > > Something like this should do the

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-05 Thread Mauro Carvalho Chehab
Em Mon, 5 Oct 2020 10:17:36 -0600 Jonathan Corbet escreveu: > On Sun, 4 Oct 2020 10:02:03 +0200 > Mauro Carvalho Chehab wrote: > > > When kernel-doc is called via kerneldoc.py, there's no need to > > auto-detect the Sphinx version, as the Sphinx module already > > knows it. So, add an optional

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-05 Thread Jonathan Corbet
On Sun, 4 Oct 2020 10:02:03 +0200 Mauro Carvalho Chehab wrote: > When kernel-doc is called via kerneldoc.py, there's no need to > auto-detect the Sphinx version, as the Sphinx module already > knows it. So, add an optional parameter to allow changing the > Sphinx dialect. > > As kernel-doc can

[PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-04 Thread Mauro Carvalho Chehab
When kernel-doc is called via kerneldoc.py, there's no need to auto-detect the Sphinx version, as the Sphinx module already knows it. So, add an optional parameter to allow changing the Sphinx dialect. As kernel-doc can also be manually called, keep the auto-detection logic if the parameter was no