linux/tools/lib/python/kdoc
Mauro Carvalho Chehab 2f07ddbd57 docs: xforms_lists: better evaluate struct_group macros
The previous approach were to unwind nested structs/unions.

Now that we have a logic that can handle it well, use it to
ensure that struct_group macros will properly reflect the
actual struct.

Note that the replacemend logic still simplifies the code
a little bit, as the basic build block for struct group is:

	union { \
		struct { MEMBERS } ATTRS; \
		struct __struct_group_tag(TAG) { MEMBERS } ATTRS NAME; \
	} ATTRS

There:

- ATTRS is meant to add extra macro attributes like __packed
  which we already discard, as they aren't relevant to
  document struct members;

- TAG is used only when built with __cplusplus.

So, instead, convert them into just:

    struct { MEMBERS };

Please notice that here, we're using the greedy version of the
backrefs, as MEMBERS is actually MEMBERS... on all such macros.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <24bf2c036b08814d9b4aabc27542fd3b2ff54424.1773770483.git.mchehab+huawei@kernel.org>
2026-03-22 15:02:29 -06:00
..
__init__.py
c_lex.py docs: c_lex: properly implement a sub() method for CMatch 2026-03-22 15:02:29 -06:00
enrich_formatter.py docs: kdoc: enrich_formatter: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
kdoc_files.py docs: kdoc_files: document KernelFiles() ABI 2026-03-09 10:23:20 -06:00
kdoc_item.py docs: kdoc_item: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
kdoc_output.py docs: kdoc_output: better handle lists 2026-03-09 10:34:39 -06:00
kdoc_parser.py docs: kdoc: replace NestedMatch with CMatch 2026-03-22 15:02:29 -06:00
kdoc_re.py docs: kdoc_re: get rid of NestedMatch class 2026-03-22 15:02:29 -06:00
latex_fonts.py docs: kdoc: latex_fonts: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
parse_data_structs.py docs: kdoc: parse_data_structs: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
python_version.py docs: kdoc: python_version: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
xforms_lists.py docs: xforms_lists: better evaluate struct_group macros 2026-03-22 15:02:29 -06:00