10cb823bba
The opening comment mark '/**' is used for highlighting the beginning of kernel-doc comments. There are certain files in drivers/crypto/nx, which follow this syntax, but the content inside does not comply with kernel-doc. Such lines were probably not meant for kernel-doc parsing, but are parsed due to the presence of kernel-doc like comment syntax(i.e, '/**'), which causes unexpected warnings from kernel-doc. E.g., presence of kernel-doc like comment in the header lines for drivers/crypto/nx/nx-sha256.c at header causes these warnings: "warning: Function parameter or member 'tfm' not described in 'nx_crypto_ctx_sha256_init'" "warning: expecting prototype for SHA(). Prototype was for nx_crypto_ctx_sha256_init() instead" Similarly for other files too. Provide a simple fix by replacing such occurrences with general comment format, i.e. '/*', to prevent kernel-doc from parsing it. Signed-off-by: Aditya Srivastava <yashsri421@gmail.com> Acked-by: Randy Dunlap <rdunlap@infradead.org> Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au> |
||
---|---|---|
.. | ||
Kconfig | ||
Makefile | ||
nx_csbcpb.h | ||
nx_debugfs.c | ||
nx-842-pseries.c | ||
nx-842.c | ||
nx-842.h | ||
nx-aes-cbc.c | ||
nx-aes-ccm.c | ||
nx-aes-ctr.c | ||
nx-aes-ecb.c | ||
nx-aes-gcm.c | ||
nx-aes-xcbc.c | ||
nx-common-powernv.c | ||
nx-sha256.c | ||
nx-sha512.c | ||
nx.c | ||
nx.h |