crypto: doc - optimize compilation
The :functions: definition allows the specification of multiple
function references which prevents parsing the header file multiple
times.
Reported-by: Jani Nikula <jani.nikula@linux.intel.com>
Signed-off-by: Stephan Mueller <smueller@chronox.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
diff --git a/Documentation/crypto/api-digest.rst b/Documentation/crypto/api-digest.rst
index b5eaf0f..07356fa 100644
--- a/Documentation/crypto/api-digest.rst
+++ b/Documentation/crypto/api-digest.rst
@@ -5,13 +5,7 @@
:doc: Message Digest Algorithm Definitions
.. kernel-doc:: include/crypto/hash.h
- :functions: hash_alg_common
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: ahash_alg
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: shash_alg
+ :functions: hash_alg_common ahash_alg shash_alg
Asynchronous Message Digest API
-------------------------------
@@ -20,40 +14,7 @@
:doc: Asynchronous Message Digest API
.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_alloc_ahash
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_free_ahash
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_init
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_digestsize
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_reqtfm
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_reqsize
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_setkey
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_finup
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_final
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_digest
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_export
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_ahash_import
+ :functions: crypto_alloc_ahash crypto_free_ahash crypto_ahash_init crypto_ahash_digestsize crypto_ahash_reqtfm crypto_ahash_reqsize crypto_ahash_setkey crypto_ahash_finup crypto_ahash_final crypto_ahash_digest crypto_ahash_export crypto_ahash_import
Asynchronous Hash Request Handle
--------------------------------
@@ -62,19 +23,7 @@
:doc: Asynchronous Hash Request Handle
.. kernel-doc:: include/crypto/hash.h
- :functions: ahash_request_set_tfm
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: ahash_request_alloc
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: ahash_request_free
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: ahash_request_set_callback
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: ahash_request_set_crypt
+ :functions: ahash_request_set_tfm ahash_request_alloc ahash_request_free ahash_request_set_callback ahash_request_set_crypt
Synchronous Message Digest API
------------------------------
@@ -83,40 +32,4 @@
:doc: Synchronous Message Digest API
.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_alloc_shash
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_free_shash
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_blocksize
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_digestsize
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_descsize
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_setkey
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_digest
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_export
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_import
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_init
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_update
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_final
-
-.. kernel-doc:: include/crypto/hash.h
- :functions: crypto_shash_finup
+ :functions: crypto_alloc_shash crypto_free_shash crypto_shash_blocksize crypto_shash_digestsize crypto_shash_descsize crypto_shash_setkey crypto_shash_digest crypto_shash_export crypto_shash_import crypto_shash_init crypto_shash_update crypto_shash_final crypto_shash_finup