On Sun, 16 Oct 2016, Stephan Mueller <smueller@xxxxxxxxxx> wrote: > Keep the cipher API and the request API function documentation in > separate sections. > > Signed-off-by: Stephan Mueller <smueller@xxxxxxxxxx> > --- > Documentation/crypto/api-akcipher.rst | 25 +++++++++++++------------ > 1 file changed, 13 insertions(+), 12 deletions(-) > > diff --git a/Documentation/crypto/api-akcipher.rst b/Documentation/crypto/api-akcipher.rst > index 305e616..0d5899f 100644 > --- a/Documentation/crypto/api-akcipher.rst > +++ b/Documentation/crypto/api-akcipher.rst > @@ -25,32 +25,32 @@ Asymmetric Cipher API > .. kernel-doc:: include/crypto/akcipher.h > :functions: crypto_akcipher_set_priv_key > > -Asymmetric Cipher Request Handle > --------------------------------- > - > .. kernel-doc:: include/crypto/akcipher.h > - :functions: akcipher_request_alloc > + :functions: crypto_akcipher_maxsize > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: akcipher_request_free > + :functions: crypto_akcipher_encrypt > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: akcipher_request_set_callback > + :functions: crypto_akcipher_decrypt > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: akcipher_request_set_crypt > + :functions: crypto_akcipher_sign > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: crypto_akcipher_maxsize > + :functions: crypto_akcipher_verify The directive parameter is plural functions for a reason - you can specify multiple functions in the same directive. Splitting this to multiple directives causes the header file to be parsed again for each directive. IMO this can be fixed in a follow-up patch. Same for other patches in this series. BR, Jani. > + > +Asymmetric Cipher Request Handle > +-------------------------------- > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: crypto_akcipher_encrypt > + :functions: akcipher_request_alloc > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: crypto_akcipher_decrypt > + :functions: akcipher_request_free > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: crypto_akcipher_sign > + :functions: akcipher_request_set_callback > > .. kernel-doc:: include/crypto/akcipher.h > - :functions: crypto_akcipher_verify > + :functions: akcipher_request_set_crypt -- Jani Nikula, Intel Open Source Technology Center -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html