* Re: [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation
2025-08-12 9:33 [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation Mauro Carvalho Chehab
@ 2025-08-12 17:43 ` Jakub Kicinski
2025-08-12 18:31 ` Jonathan Corbet
2025-08-15 0:40 ` patchwork-bot+netdevbpf
2 siblings, 0 replies; 6+ messages in thread
From: Jakub Kicinski @ 2025-08-12 17:43 UTC (permalink / raw)
To: Mauro Carvalho Chehab
Cc: Jonathan Corbet, EDAC Mailing List, Linux Kernel Mailing List,
Linux Doc Mailing List, Akira Yokosawa, David S. Miller,
Ignacio Encinas Rubio, Marco Elver, Shuah Khan, Donald Hunter,
Eric Dumazet, Jan Stancek, Paolo Abeni, Ruben Wauters, joel,
linux-kernel-mentees, lkmm, netdev, peterz, stern, Breno Leitao,
Randy Dunlap, Simon Horman
On Tue, 12 Aug 2025 11:33:29 +0200 Mauro Carvalho Chehab wrote:
> The patch content is identical to my v10 submission:
>
> https://lore.kernel.org/linux-doc/cover.1753718185.git.mchehab+huawei@kernel.org/
Thank you! We'll merge on Thu, FWIW, after we fast forward to Linus.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation
2025-08-12 9:33 [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation Mauro Carvalho Chehab
2025-08-12 17:43 ` Jakub Kicinski
@ 2025-08-12 18:31 ` Jonathan Corbet
2025-08-12 18:41 ` Randy Dunlap
2025-08-15 0:40 ` patchwork-bot+netdevbpf
2 siblings, 1 reply; 6+ messages in thread
From: Jonathan Corbet @ 2025-08-12 18:31 UTC (permalink / raw)
To: Mauro Carvalho Chehab, Jakub Kicinski
Cc: EDAC Mailing List, Linux Kernel Mailing List,
Linux Doc Mailing List, linux-kernel, Akira Yokosawa,
David S. Miller, Ignacio Encinas Rubio, Marco Elver, Shuah Khan,
Donald Hunter, Eric Dumazet, Jan Stancek, Paolo Abeni,
Ruben Wauters, joel, linux-kernel-mentees, lkmm, netdev, peterz,
stern, Breno Leitao, Randy Dunlap, Simon Horman
Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:
> Hi Jon/Jakub,
>
> In case you both prefer to merge from a stable tag, please pull from:
>
> git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-docs.git docs/v6.17-1
>
> For:
>
> - An YAML parser Sphinx plugin, integrated with Netlink YAML doc
> parser.
OK, I have done that. I will note that it adds a warning:
> Documentation/networking/netlink_spec/index.rst: WARNING: document isn't included in any toctree
...it might be nice to get that straightened out.
Thanks,
jon
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation
2025-08-12 18:31 ` Jonathan Corbet
@ 2025-08-12 18:41 ` Randy Dunlap
2025-08-12 19:23 ` Mauro Carvalho Chehab
0 siblings, 1 reply; 6+ messages in thread
From: Randy Dunlap @ 2025-08-12 18:41 UTC (permalink / raw)
To: Jonathan Corbet, Mauro Carvalho Chehab, Jakub Kicinski
Cc: EDAC Mailing List, Linux Kernel Mailing List,
Linux Doc Mailing List, Akira Yokosawa, David S. Miller,
Ignacio Encinas Rubio, Marco Elver, Shuah Khan, Donald Hunter,
Eric Dumazet, Jan Stancek, Paolo Abeni, Ruben Wauters, joel,
linux-kernel-mentees, lkmm, netdev, peterz, stern, Breno Leitao,
Simon Horman
On 8/12/25 11:31 AM, Jonathan Corbet wrote:
> Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:
>
>> Hi Jon/Jakub,
>>
>> In case you both prefer to merge from a stable tag, please pull from:
>>
>> git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-docs.git docs/v6.17-1
>>
>> For:
>>
>> - An YAML parser Sphinx plugin, integrated with Netlink YAML doc
>> parser.
>
> OK, I have done that. I will note that it adds a warning:
>
>> Documentation/networking/netlink_spec/index.rst: WARNING: document isn't included in any toctree
>
> ...it might be nice to get that straightened out.
I see it, at least in linux-next. However, its format is
"different," so that may have confused whatever printed
that message:
from Documentation/networking/index.rst:
filter
generic-hdlc
generic_netlink
netlink_spec/index
gen_stats
gtp
ila
--
~Randy
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation
2025-08-12 18:41 ` Randy Dunlap
@ 2025-08-12 19:23 ` Mauro Carvalho Chehab
0 siblings, 0 replies; 6+ messages in thread
From: Mauro Carvalho Chehab @ 2025-08-12 19:23 UTC (permalink / raw)
To: Randy Dunlap
Cc: Jonathan Corbet, Jakub Kicinski, EDAC Mailing List,
Linux Kernel Mailing List, Linux Doc Mailing List, Akira Yokosawa,
David S. Miller, Ignacio Encinas Rubio, Marco Elver, Shuah Khan,
Donald Hunter, Eric Dumazet, Jan Stancek, Paolo Abeni,
Ruben Wauters, joel, linux-kernel-mentees, lkmm, netdev, peterz,
stern, Breno Leitao, Simon Horman
On Tue, 12 Aug 2025 11:41:58 -0700
Randy Dunlap <rdunlap@infradead.org> wrote:
> On 8/12/25 11:31 AM, Jonathan Corbet wrote:
> > Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:
> >
> >> Hi Jon/Jakub,
> >>
> >> In case you both prefer to merge from a stable tag, please pull from:
> >>
> >> git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-docs.git docs/v6.17-1
> >>
> >> For:
> >>
> >> - An YAML parser Sphinx plugin, integrated with Netlink YAML doc
> >> parser.
> >
> > OK, I have done that. I will note that it adds a warning:
> >
> >> Documentation/networking/netlink_spec/index.rst: WARNING: document isn't included in any toctree
> > ...it might be nice to get that straightened out.
>
> I see it, at least in linux-next. However, its format is
> "different," so that may have confused whatever printed
> that message:
>
> from Documentation/networking/index.rst:
>
> filter
> generic-hdlc
> generic_netlink
> netlink_spec/index
> gen_stats
> gtp
> ila
Maybe some merge conflict/merge issue, as this was renamed:
$ git show 1ce4da3dd99e98bd4a8b396c291041080e0fe85e Documentation/networking/index.rst
commit 1ce4da3dd99e98bd4a8b396c291041080e0fe85e
Author: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Date: Thu Jun 12 10:34:30 2025 +0200
docs: use parser_yaml extension to handle Netlink specs
Instead of manually calling ynl_gen_rst.py, use a Sphinx extension.
This way, no .rst files would be written to the Kernel source
directories.
We are using here a toctree with :glob: property. This way, there
is no need to touch the netlink/specs/index.rst file every time
a new Netlink spec is added/renamed/removed.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Donald Hunter <donald.hunter@gmail.com>
diff --git a/Documentation/networking/index.rst b/Documentation/networking/index.rst
index ac90b82f3ce9..b7a4969e9bc9 100644
--- a/Documentation/networking/index.rst
+++ b/Documentation/networking/index.rst
@@ -57,7 +57,7 @@ Contents:
filter
generic-hdlc
generic_netlink
- netlink_spec/index
+ ../netlink/specs/index
gen_stats
gtp
ila
Thanks,
Mauro
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation
2025-08-12 9:33 [GIT PULL for v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation Mauro Carvalho Chehab
2025-08-12 17:43 ` Jakub Kicinski
2025-08-12 18:31 ` Jonathan Corbet
@ 2025-08-15 0:40 ` patchwork-bot+netdevbpf
2 siblings, 0 replies; 6+ messages in thread
From: patchwork-bot+netdevbpf @ 2025-08-15 0:40 UTC (permalink / raw)
To: Mauro Carvalho Chehab
Cc: corbet, kuba, linux-edac, linux-kernel, linux-doc, akiyks, davem,
ignacio, elver, skhan, donald.hunter, edumazet, jstancek, pabeni,
rubenru09, joel, linux-kernel-mentees, lkmm, netdev, peterz,
stern, leitao, rdunlap, horms
Hello:
This pull request was applied to netdev/net-next.git (main)
by Jakub Kicinski <kuba@kernel.org>:
On Tue, 12 Aug 2025 11:33:29 +0200 you wrote:
> Hi Jon/Jakub,
>
> In case you both prefer to merge from a stable tag, please pull from:
>
> git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-docs.git docs/v6.17-1
>
> For:
>
> [...]
Here is the summary with links:
- [GIT,PULL,for,v6.17-rc2] add a generic yaml parser integrated with Netlink specs generation
https://git.kernel.org/netdev/net-next/c/c4f72d3747ac
You are awesome, thank you!
--
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html
^ permalink raw reply [flat|nested] 6+ messages in thread