[PATCH 0/8] Yet another set of kerneldoc simplifications

From: Jonathan Corbet
Date: Fri Jun 27 2025 - 14:40:32 EST


As I continue to work through our shiny new kerneldoc, I keep finding ways
to make it (IMO) shinier. This set covers these basic areas:

- Remove some unused fields from the KernelEntry class, and encapsulate the
handling of the section contentions therein.

- Clean up and optimize the EXPORT_SYMBOL processing slightly.

- Rework the handling of inline comments by getting rid of the substate
design and separating out the processing of the states that remain.

The series results in no changes in the generated output.

Jonathan Corbet (8):
docs: kdoc: remove KernelEntry::in_doc_sect
docs: kdoc: Move content handling into KernelEntry
docs: kdoc: remove a bit of dead code
docs: kdoc: remove KernelEntry::function
docs: kdoc: rework process_export() slightly
docs: kdoc: remove the INLINE_END state
docs: kdoc: remove the inline states-within-a-state
docs: kdoc: split the processing of the two remaining inline states

scripts/lib/kdoc/kdoc_parser.py | 170 +++++++++++++-------------------
1 file changed, 67 insertions(+), 103 deletions(-)

--
2.49.0