Re: [cryptodev:master 144/149] DockBook: Warning(include/crypto/aead.h): no structured comments found

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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'
>>> 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
--
To unsubscribe from this list: send the line "unsubscribe linux-crypto" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel]     [Gnu Classpath]     [Gnu Crypto]     [DM Crypt]     [Netfilter]     [Bugtraq]

  Powered by Linux