]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
Merge tag 'docs/v6.17-1' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab...
authorJonathan Corbet <corbet@lwn.net>
Tue, 12 Aug 2025 18:23:57 +0000 (12:23 -0600)
committerJonathan Corbet <corbet@lwn.net>
Tue, 12 Aug 2025 18:23:57 +0000 (12:23 -0600)
commit577a49cf285da98b885318b82b328074e38bee73
treed7a4e941f2ad51447c09b1434988cce0ec0a2cc0
parent2115dc3e3376b7bd5021950b45eebbcd992e9be9
parent47459937be8031aae6aaa17ac5f60985f7c9e1bd
Merge tag 'docs/v6.17-1' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-docs into mauro

Mauro says:

As discussed at:
   https://lore.kernel.org/all/20250610101331.62ba466f@foz.lan/

changeset f061c9f7d058 ("Documentation: Document each netlink family")
added a logic which generates *.rst files inside $(srctree). This is bad
when O=<BUILDDIR> is used.

A recent change renamed the yaml files used by Netlink, revealing a bad
side effect: as "make cleandocs" don't clean the produced files and symbols
appear duplicated for people that don't build the kernel from scratch.

This series adds an yaml parser extension and uses an index file with glob for
*. We opted to write such extension in a way that no actual yaml conversion
code is inside it. This makes it flexible enough to handle other types of yaml
files in the future. The actual yaml conversion logic were placed at
netlink_yml_parser.py.

As requested by YNL maintainers, this version has netlink_yml_parser.py
inside tools/net/ynl/pyynl/ directory. I don't like mixing libraries with
binaries, nor to have Python libraries spread all over the Kernel. IMO,
the best is to put all of them on a common place (scripts/lib, python/lib,
lib/python, ...) but, as this can be solved later, for now let's keep it this
way.