netdev - Re: [PATCH v2 net-next] net/iucv: clean up iucv kernel-doc warnings

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: <823b3697-d806-47f6-8815-fe17a616bf97@linux.ibm.com>
Date: Tue, 3 Feb 2026 10:39:23 +0100
From: Alexandra Winter <wintera@...ux.ibm.com>
To: Randy Dunlap <rdunlap@...radead.org>, netdev@...r.kernel.org
Cc: Thorsten Winkler <twinkler@...ux.ibm.com>, linux-s390@...r.kernel.org,
        "David S. Miller" <davem@...emloft.net>,
        Eric Dumazet <edumazet@...gle.com>, Jakub Kicinski <kuba@...nel.org>,
        Paolo Abeni <pabeni@...hat.com>, Simon Horman <horms@...nel.org>
Subject: Re: [PATCH v2 net-next] net/iucv: clean up iucv kernel-doc warnings



On 02.02.26 23:07, Randy Dunlap wrote:
>> All the fixes look good to me. And they get rid of the mentioned warnings.
>> I appreciate your approach to use the existing wording, though it may not
>> be according to the latest style guidelines.
> Is that IBM style guidelines or kernel?

I was referring to kernel style. I'm not saying that any rules are broken, but
some of the 'short descriptions' are a bit verbose. Mix of imperative and present mood,
Periods at the end of descriptions, etc
I don't think it's worth polishing that, I'd rather keep the original wording of the authors.
I highly appreciate getting rid of the warnings.