Subject: Re: [PATCH v4 2/2] doc/netlink: Expand nftables specification

From: Jakub Kicinski <[email-masked]>
Date: Wed, 19 Nov 2025 20:03:04 -0800

On Wed, 19 Nov 2025 18:16:00 +0000 Remy D. Farley wrote:
> Getting out some changes I've accumulated while making nftables work
> with Rust netlink-bindings. Hopefully, this will be useful upstream.

In the future it's better to keep things in smaller patches.
Easier to review.

The docs have to be in ReST-compatible format I see:

Documentation/netlink/specs/nftables.yaml:66: WARNING: Field list ends without a blank line; unexpected unindent.
Documentation/netlink/specs/nftables.yaml:261: WARNING: Bullet list ends without a blank line; unexpected unindent.
Documentation/netlink/specs/nftables.yaml:261: WARNING: Field list ends without a blank line; unexpected unindent.

`make htmldocs` to repro

> +    # Defined in include/linux/netfilter/nf_tables.h

Isn't this the main header for nf_tables?
If yes then no need to comment, should be the obvious place.
If no - can we use 
	
	header: linux/netfilter/nf_tables.h

?

Last but not least when you post v2 please CC folks from netfilter:

NETFILTER
M:	Pablo Neira Ayuso <[email-masked]>
M:	Jozsef Kadlecsik <[email-masked]>
M:	Florian Westphal <[email-masked]>
R:	Phil Sutter <[email-masked]>
L:	[email-masked]
L:	[email-masked]
S:	Maintained