Some attribute-set have a documentation (doc:), but they are not
displayed in the RST / HTML version. This series adds the missing
parsing of these 'doc' fields.
While at it, it also fixes how the 'doc' fields are declared on multiple
lines.
Signed-off-by: Matthieu Baerts (NGI0) <matttbe@kernel.org>
---
Changes in v3:
- patch 2: avoid warnings reported by the CI (NIPA/Jakub)
- Link to v2: https://lore.kernel.org/r/20250912-net-next-ynl-attr-doc-rst-v2-0-c44d36a99992@kernel.org
Changes in v2:
- patch 2 & 3: new
- Link to v1: https://lore.kernel.org/r/20250910-net-next-ynl-attr-doc-rst-v1-1-0bbc77816174@kernel.org
---
Matthieu Baerts (NGI0) (3):
tools: ynl: rst: display attribute-set doc
netlink: specs: team: avoid mangling multilines doc
netlink: specs: explicitly declare block scalar strings
Documentation/netlink/specs/conntrack.yaml | 2 +-
Documentation/netlink/specs/netdev.yaml | 22 +++++++++++-----------
Documentation/netlink/specs/nftables.yaml | 2 +-
Documentation/netlink/specs/nl80211.yaml | 2 +-
Documentation/netlink/specs/ovs_datapath.yaml | 2 +-
Documentation/netlink/specs/ovs_flow.yaml | 2 +-
Documentation/netlink/specs/ovs_vport.yaml | 2 +-
Documentation/netlink/specs/rt-addr.yaml | 2 +-
Documentation/netlink/specs/rt-link.yaml | 2 +-
Documentation/netlink/specs/rt-neigh.yaml | 2 +-
Documentation/netlink/specs/rt-route.yaml | 2 +-
Documentation/netlink/specs/rt-rule.yaml | 2 +-
Documentation/netlink/specs/tc.yaml | 2 +-
Documentation/netlink/specs/team.yaml | 6 ++++--
tools/net/ynl/pyynl/lib/doc_generator.py | 4 ++++
15 files changed, 31 insertions(+), 25 deletions(-)
---
base-commit: fc006f5478fcf07d79b35e9dcdc51ecd11a6bf82
change-id: 20250910-net-next-ynl-attr-doc-rst-b61532634245
Best regards,
--
Matthieu Baerts (NGI0) <matttbe@kernel.org>