]> asedeno.scripts.mit.edu Git - linux.git/commit
crypto: doc - clear htmldocs build warnings for crypto/hash
authortcharding <me@tobin.cc>
Sat, 6 Jan 2018 23:01:43 +0000 (10:01 +1100)
committerHerbert Xu <herbert@gondor.apana.org.au>
Fri, 12 Jan 2018 12:03:44 +0000 (23:03 +1100)
commitb40fa82cd6138350f723aa47b37e3e3e80906b40
tree6b81e96c62b78d8f18614b8c2a5f528465187b27
parentc9a3ff8f22a2df5ec6de18ba616a863392269a10
crypto: doc - clear htmldocs build warnings for crypto/hash

SPHINX build emits multiple warnings of kind:

warning: duplicate section name 'Note'

(when building kernel via make target 'htmldocs')

This is caused by repeated use of comments of form:

* Note: soau soaeusoa uoe

We can change the format without loss of clarity and clear the build
warnings.

Add '**[mandatory]**' or '**[optional]**' as kernel-doc field element
description prefix

This renders in HTML as (prefixes in bold)

final
    [mandatory] Retrieve result from the driver. This function finalizes the
    transformation and retrieves the resulting hash from the driver and
    pushes it back to upper layers. No data processing happens at this
    point unless hardware requires it to finish the transformation (then
    the data buffered by the device driver is processed).

Signed-off-by: Tobin C. Harding <me@tobin.cc>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
include/crypto/hash.h