linux/tools/lib/python
Tudor Ambarus 8bf5a177c3 docs: kernel-doc: python: strip __counted_by_ptr macro
The `__counted_by_ptr` macro was recently introduced [1] to extend
bounds checking semantics to standard dynamically allocated pointers.

However, the new Python implementation of kernel-doc does not currently
recognize it as a compiler attribute. When kernel-doc encounters a
struct member annotated with this macro, it fails to parse the variable
name correctly, resulting in false-positive warnings like:

  Warning: ... struct member '__counted_by_ptr(cmdcnt' not described

Add `__counted_by_ptr` to the `struct_xforms` regex list so it gets
safely stripped out during the parsing phase, mirroring the existing
behavior for `__counted_by`. Update the corresponding unit tests.

Link: https://git.kernel.org/torvalds/c/150a04d817d8 [1]
Signed-off-by: Tudor Ambarus <tudor.ambarus@linaro.org>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Kees Cook <kees@kernel.org>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20260506-kdoc-__counted_by_ptr-v1-1-70763486871f@linaro.org>
2026-05-15 08:11:36 -06:00
..
abi docs: kabi: helpers: add documentation for each "enum" value 2026-01-23 11:37:39 -07:00
feat docs: parse_features: make documentation more consistent 2026-01-23 11:37:39 -07:00
kdoc docs: kernel-doc: python: strip __counted_by_ptr macro 2026-05-15 08:11:36 -06:00
__init__.py
jobserver.py jobserver: Fix typo in docstring 2026-03-17 08:43:39 -06:00
unittest_helper.py tools: unittest_helper: add a quiet mode 2026-03-30 10:54:13 -06:00