Mauro Carvalho Chehab cca1bbdd72 docs: kdoc_parser: don't mangle with function defines ...

Mangling with #defines is not nice, as we may end removing
the macro names, preventing several macros from being properly
documented.

Also, on defines, we have something like:

	#define foo(a1, a2, a3, ...)			 \
		/* some real implementation */

The prototype part (first line on this example) won't contain
any macros, so no need to apply any regexes on it.

With that, move the apply_transforms() logic to ensure that
it will be called only on functions.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <8f9854c8ca1c794b6a3fe418f7adbc32aa68b432.1772469446.git.mchehab+huawei@kernel.org>

2026-03-03 10:47:24 -07:00

..

__init__.py

docs: bring some order to our Python module hierarchy

2025-11-18 09:22:40 -07: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: Improve docstrings and comments

2026-01-23 11:37:38 -07: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: Improve docstrings and comments

2026-01-23 11:37:38 -07:00

kdoc_parser.py

docs: kdoc_parser: don't mangle with function defines

2026-03-03 10:47:24 -07:00

kdoc_re.py

docs: kdoc_re: don't go past the end of a line

2026-03-03 10:47:24 -07: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