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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20250627184000.132291-1-corbet@lwn.net>
Date: Fri, 27 Jun 2025 12:39:52 -0600
From: Jonathan Corbet <corbet@....net>
To: linux-doc@...r.kernel.org
Cc: linux-kernel@...r.kernel.org,
	Mauro Carvalho Chehab <mchehab+huawei@...nel.org>,
	Akira Yokosawa <akiyks@...il.com>,
	Jonathan Corbet <corbet@....net>
Subject: [PATCH 0/8] Yet another set of kerneldoc simplifications

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