docs: kdoc: Coalesce parameter-list handling
authorJonathan Corbet <corbet@lwn.net>
Wed, 2 Jul 2025 19:05:56 +0000 (13:05 -0600)
committerJonathan Corbet <corbet@lwn.net>
Tue, 15 Jul 2025 19:43:16 +0000 (13:43 -0600)
commitde6f7ac91a08d723a6eaa9c5bbce30c5a126c861
treedfc29196cbd44df8ad1bca8df4ea6260deae9a5c
parentefacdf85135ae02a8c25452e40547b773bb1b6b3
docs: kdoc: Coalesce parameter-list handling

Callers to output_declaration() always pass the parameter information from
self.entry; remove all of the boilerplate arguments and just get at that
information directly.  Formalize its placement in the KdocItem class.

It would be nice to get rid of parameterlist as well, but that has the
effect of reordering the output of function parameters and struct fields to
match the order in the kerneldoc comment rather than in the declaration.
One could argue about which is more correct, but the ordering has been left
unchanged for now.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/lib/kdoc/kdoc_item.py
scripts/lib/kdoc/kdoc_output.py
scripts/lib/kdoc/kdoc_parser.py