Re: [cryptodev:master 144/149] DockBook: Warning(include/crypto/aead.h): no structured comments found
From: Stephan Mueller <hidden>
Date: 2015-08-17 13:28:57
Am Montag, 17. August 2015, 21:14:27 schrieb kbuild test robot: Hi, thanks for the report.
tree: git://git.kernel.org/pub/scm/linux/kernel/git/herbert/cryptodev-2.6.git master head: dd43c4e92fbb135dcbf02845578db60be56a453a commit: b0d955ba4688fcba8112884931aea1f1e6f50f03 [144/149] crypto: aead - Remove old AEAD interfaces reproduce: make htmldocs All warnings (new ones prefixed by >>): Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base' Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member '__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No description found for parameter 'base'quoted
quoted
Warning(include/crypto/aead.h): no structured comments found
This is an error in the parser tool in scripts/. I tried to find the issue, but the tool I was not able to. At least this is nothing that can be fixed in the documentation.
Was looking for 'aead_request_set_assoc'.
Warning(include/crypto/aead.h:98): Excess struct/union/enum/typedef member
'__ctx' description in 'aead_request' Warning(include/crypto/aead.h:149): No
description found for parameter 'base' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning(include/crypto/hash.h:188):
No description found for parameter 'hash_alg_common))))'
Warning(include/crypto/hash.h:188): Excess struct/union/enum/typedef member
'digestsize' description in 'shash_alg' Warning: didn't use docs for
crypto_rng_generateThis one is kind of true as we do not document hash_alg_common as it is the used data structure is documented. Adding another description looks strange to me. Ciao Stephan