All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] crypto: wp512: correct a non-kernel-doc comment
@ 2021-08-08 20:52 Randy Dunlap
  2021-08-12 11:36 ` Herbert Xu
  0 siblings, 1 reply; 2+ messages in thread
From: Randy Dunlap @ 2021-08-08 20:52 UTC (permalink / raw)
  To: linux-kernel; +Cc: Randy Dunlap, Herbert Xu, David S. Miller, linux-crypto

Don't use "/**" to begin a comment that is not kernel-doc notation.

crypto/wp512.c:779: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 * The core Whirlpool transform.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Herbert Xu <herbert@gondor.apana.org.au>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: linux-crypto@vger.kernel.org
---
 crypto/wp512.c |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

--- linux-next-20210806.orig/crypto/wp512.c
+++ linux-next-20210806/crypto/wp512.c
@@ -775,7 +775,7 @@ static const u64 rc[WHIRLPOOL_ROUNDS] =
 	0xca2dbf07ad5a8333ULL,
 };
 
-/**
+/*
  * The core Whirlpool transform.
  */
 

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] crypto: wp512: correct a non-kernel-doc comment
  2021-08-08 20:52 [PATCH] crypto: wp512: correct a non-kernel-doc comment Randy Dunlap
@ 2021-08-12 11:36 ` Herbert Xu
  0 siblings, 0 replies; 2+ messages in thread
From: Herbert Xu @ 2021-08-12 11:36 UTC (permalink / raw)
  To: Randy Dunlap; +Cc: linux-kernel, David S. Miller, linux-crypto

On Sun, Aug 08, 2021 at 01:52:33PM -0700, Randy Dunlap wrote:
> Don't use "/**" to begin a comment that is not kernel-doc notation.
> 
> crypto/wp512.c:779: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
>  * The core Whirlpool transform.
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Herbert Xu <herbert@gondor.apana.org.au>
> Cc: "David S. Miller" <davem@davemloft.net>
> Cc: linux-crypto@vger.kernel.org
> ---
>  crypto/wp512.c |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)

Patch applied.  Thanks.
-- 
Email: Herbert Xu <herbert@gondor.apana.org.au>
Home Page: http://gondor.apana.org.au/~herbert/
PGP Key: http://gondor.apana.org.au/~herbert/pubkey.txt

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2021-08-12 11:37 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-08-08 20:52 [PATCH] crypto: wp512: correct a non-kernel-doc comment Randy Dunlap
2021-08-12 11:36 ` Herbert Xu

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.