linux/scripts/lib/kdoc
Jonathan Corbet e65d54e191 docs: kdoc: rework the handling of SPECIAL_SECTION
Move the recognition of this state to when we enter it, rather than when we
exit, eliminating some twisty logic along the way.

Some changes in output do result from this shift, generally for kerneldoc
comments that do not quite fit the format.  See, for example,
struct irqdomain.  As far as I can tell, the new behavior is more correct
in each case.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20250621203512.223189-7-corbet@lwn.net
2025-06-25 11:30:26 -06:00
..
kdoc_files.py scripts: kernel-doc: prevent a KeyError when checking output 2025-05-21 03:53:40 -06:00
kdoc_output.py scripts/lib/kdoc: change mode to 0644 2025-04-28 17:28:14 -06:00
kdoc_parser.py docs: kdoc: rework the handling of SPECIAL_SECTION 2025-06-25 11:30:26 -06:00
kdoc_re.py scripts/lib/kdoc: change mode to 0644 2025-04-28 17:28:14 -06:00