linux-kernel - Re: [PATCH 1/2] Documentation: devres: add missing mailbox helpers

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: <87ikssqkiw.fsf@trenco.lwn.net>
Date: Tue, 12 Nov 2024 13:12:07 -0700
From: Jonathan Corbet <corbet@....net>
To: David Lechner <dlechner@...libre.com>, anish kumar
 <yesanishhere@...il.com>, broonie@...nel.org,
 u.kleine-koenig@...gutronix.de, Jonathan.Cameron@...wei.com,
 pstanner@...hat.com
Cc: linux-kernel@...r.kernel.org, linux-doc@...r.kernel.org
Subject: Re: [PATCH 1/2] Documentation: devres: add missing mailbox helpers

David Lechner <dlechner@...libre.com> writes:

> On 11/6/24 5:52 PM, anish kumar wrote:
>> mailbox api's were missing from the devres documentation.
>> This patch adds them.
>
> I've been wondering... Is it really that useful to have all
> of the devn_ functions listed in the documentation?

Not particularly, no.

Far better would be to use the docs build system to bring in the
kerneldoc comments that are there for at least a good subset of those
functions.

Thanks,

jon