mirror-linux/tools
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
..
accounting delayacct: fix build regression on accounting tool 2026-02-12 15:45:56 -08:00
arch perf tools changes for v7.0: 2026-02-21 10:51:08 -08:00
bootconfig
bpf bpftool: Fix truncated netlink dumps 2026-02-17 16:54:03 -08:00
build tools build: Fix feature test for rust compiler 2026-02-12 17:45:22 -03:00
certs
cgroup
counter
crypto
debugging
dma
docs tools/docs/checktransupdate.py: fix all issues reported by pylint 2026-03-22 14:55:21 -06:00
firewire
firmware
gpio
hv
iio
include perf tools changes for v7.0: 2026-02-21 10:51:08 -08:00
kvm/kvm_stat
laptop
leds
lib docs: xforms_lists: better evaluate struct_group macros 2026-03-22 15:02:29 -06:00
memory-model
mm
net NFSD 7.0 Release Notes 2026-02-12 08:23:53 -08:00
objtool Rust fixes for v7.0-rc1 2026-02-22 08:43:31 -08:00
pcmcia
perf perf tools changes for v7.0: 2026-02-21 10:51:08 -08:00
power turbostat-2026.02.14-AMD-RAPL-fix 2026-02-18 09:52:38 -08:00
rcu
sched
sched_ext tools/sched_ext: fix getopt not re-parsed on restart 2026-02-20 17:17:38 -10:00
scripts perf test workload: Add code_with_type test workload 2026-02-08 19:16:24 -03:00
sound
spi spi: tools: Add include folder to .gitignore 2026-02-09 12:27:31 +00:00
testing sched_ext: Fixes for v7.0 2026-02-21 09:38:59 -08:00
thermal
time
tracing
unittests unittests: test_cmatch: add tests for sub() 2026-03-22 15:02:29 -06:00
usb
verification
virtio
wmi
workqueue
writeback
Makefile