Thread (2 messages) 2 messages, 2 authors, 2015-08-17

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_generate
This 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
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help