docs: kdoc: Add some comments to process_decl()
authorJonathan Corbet <corbet@lwn.net>
Sat, 21 Jun 2025 20:35:11 +0000 (14:35 -0600)
committerJonathan Corbet <corbet@lwn.net>
Wed, 25 Jun 2025 17:30:26 +0000 (11:30 -0600)
commitccad65a494657e899f9139174fcc74c64316c10a
tree33def2fad08c5d96cb256bc336cb77342aa733dc
parent2ad02b94914ab47b3b94274856e1b56cd94d3e31
docs: kdoc: Add some comments to process_decl()

Now that the function can actually fit into a human brain, add a few
comments.  While I was at it, I switched to the trim_whitespace() helper
rather than open-coding it.

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-9-corbet@lwn.net
scripts/lib/kdoc/kdoc_parser.py