Changes in kdoc_yaml_file.py

e786fab2cfcc9ab65adf35d2eab4ca94abe1955f - docs: kdoc_yaml_file: use a better name for the tests

Mon, 23 Mar 2026 10:10:51 +0100

docs: kdoc_yaml_file: use a better name for the testsInstead of always using a name with a number on it, usethe name of the object directly whenever possible.When the name is already used, append a number prefix atthe end.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/lib/python/kdoc/kdoc_yaml_file.py

99ec67a9984fdf38c7ed78695aeb1b99cfee5b50 - docs: kdoc: better handle source when producing YAML output

Mon, 23 Mar 2026 10:10:50 +0100

docs: kdoc: better handle source when producing YAML outputThe current logic was storing symbols source code on a list,not linked to the actual KdocItem. While this works fine whenkernel-doc markups are OK, on places where there is a "/**"without a valid kernel-doc markup, it ends that the 1:1 matchbetween source code and KdocItem doesn't happen, causingproblems to generate the YAML output.Fix it by storing the source code directly into the KdocItemstructure.This shouldn't affect performance or memory footprint, exceptwhen --yaml option is used.While here, add a __repr__() function for KdocItem, as ithelps debugging it.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <77902dafabb5c3250486aa2dc1568d5fafa95c5b.1774256269.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/kdoc_yaml_file.py

6e0d7b63676b85490bbaf01c9a8ebcd692bed981 - docs: kdoc_yaml_file: add a representer to make strings look nicer

Mon, 23 Mar 2026 10:10:47 +0100

docs: kdoc_yaml_file: add a representer to make strings look nicerThe strings representation is not ok, currently. Add a helperfunction to improve it, and drop blank lines at beginning andat the end of the dumpsSigned-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <422041a8b49b2609de5749092fe074b7948c32a6.1774256269.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/kdoc_yaml_file.py

b37b3cbbb1f1a99bc8b95d9f00fcf887c27f4770 - docs: add a new file to write kernel-doc output to a YAML file

Wed, 18 Mar 2026 10:11:13 +0100

docs: add a new file to write kernel-doc output to a YAML fileStoring kernel-doc output is helpful to allow debugging problemson it and to preparate unit tests.Add a class to store such contents at the same format as definedat kdoc-test-schema.yaml.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <5d084ca1a91f6a620534a1135d1b8183d934319a.1773823995.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/kdoc_yaml_file.py