docs: kdoc: don't reinvent string.strip()
authorJonathan Corbet <corbet@lwn.net>
Fri, 27 Jun 2025 19:08:20 +0000 (13:08 -0600)
committerJonathan Corbet <corbet@lwn.net>
Fri, 27 Jun 2025 19:35:46 +0000 (13:35 -0600)
commit362ec251a6aba32c8d950f0278c75aaa8c1b0b10
tree643ca30694e09fe71d1dba17e48552bfb9ca6dc3
parentc7eedb09417e4372183bf1843676d2008da340d5
docs: kdoc: don't reinvent string.strip()

process_proto_type() and process_proto_function() reinventing the strip()
string method with a whole series of separate regexes; take all that out
and just use strip().

The previous implementation also (in process_proto_type()) removed C++
comments *after* the above dance, leaving trailing whitespace in that case;
now we do the stripping afterward.  This results in exactly one output
change: the removal of a spurious space in the definition of
BACKLIGHT_POWER_REDUCED - see
https://docs.kernel.org/gpu/backlight.html#c.backlight_properties.

I note that we are putting semicolons after #define lines that really
shouldn't be there - a task for another day.

Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/lib/kdoc/kdoc_parser.py