linux-kernel - Re: [PATCH -next] btrfs: Fix kernel-doc formatting issues

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 for Android: free password hash cracker in your pocket

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

Date:   Thu, 16 Dec 2021 14:31:06 +0100
From:   David Sterba <dsterba@...e.cz>
To:     Yang Li <yang.lee@...ux.alibaba.com>
Cc:     clm@...com, josef@...icpanda.com, dsterba@...e.com,
        linux-btrfs@...r.kernel.org, linux-kernel@...r.kernel.org,
        Abaci Robot <abaci@...ux.alibaba.com>
Subject: Re: [PATCH -next] btrfs: Fix kernel-doc formatting issues

On Thu, Dec 16, 2021 at 03:08:13PM +0800, Yang Li wrote:
> Add function names to the kernel-doc of some functions and upgrade
> descriptions of some parameters in it.
> 
> The warnings were found by running scripts/kernel-doc, which is
> caused by using 'make W=1'.

Thanks, we care only about the argument list that the kdoc format and
script can verify, the rest is not really useful for internal functions
and makes it less pleasant to read.  The script will report that though
but we won't fix it, rather would like to see the script updated to
skip that.