linux-kernel - Re: [PATCH] kernel-doc: document object-like preprocessor macros

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-prev] [day] [month] [year] [list]

Message-ID: <87il3abmnt.fsf@meer.lwn.net>
Date: Tue, 30 Jan 2024 13:18:14 -0700
From: Jonathan Corbet <corbet@....net>
To: Daniel Vetter <daniel.vetter@...ll.ch>, LKML <linux-kernel@...r.kernel.org>
Cc: DRI Development <dri-devel@...ts.freedesktop.org>, Daniel Vetter
 <daniel.vetter@...ll.ch>, Randy Dunlap <rdunlap@...radead.org>, Thomas
 Zimmermann <tzimmermann@...e.de>, Maxime Ripard <mripard@...nel.org>,
 "Steven Rostedt (Google)" <rostedt@...dmis.org>,
 linux-doc@...r.kernel.org, Daniel Vetter <daniel.vetter@...el.com>
Subject: Re: [PATCH] kernel-doc: document object-like preprocessor macros

Daniel Vetter <daniel.vetter@...ll.ch> writes:

> I had no idea this exists, but Randy pointed out it's been added quite
> a long time ago in cbb4d3e6510b ("scripts/kernel-doc: handle
> object-like macros"). Definitely way before I started to write all the
> drm docs sadly, so there's a few things where I skipped writing
> kernel-doc since I didn't know it was possible.
>
> Fix this asap by documenting the two possible kernel-doc flavours for
> preprocessor definitions.
>
> References: https://lore.kernel.org/dri-devel/dd917333-9ae8-4e76-991d-39b6229ba8ce@infradead.org/
> Cc: Randy Dunlap <rdunlap@...radead.org>
> Cc: Thomas Zimmermann <tzimmermann@...e.de>
> Cc: Maxime Ripard <mripard@...nel.org>
> Cc: Daniel Vetter <daniel.vetter@...ll.ch>
> Cc: "Steven Rostedt (Google)" <rostedt@...dmis.org>
> Cc: Jonathan Corbet <corbet@....net>
> Cc: linux-doc@...r.kernel.org
> Signed-off-by: Daniel Vetter <daniel.vetter@...el.com>
> ---
>  Documentation/doc-guide/kernel-doc.rst | 26 ++++++++++++++++++++++++++
>  1 file changed, 26 insertions(+)

Applied, thanks.

jon