Improve block doxygen [ci skip]

1 files changed, 6 insertions, 3 deletions

diff --git a/src/lib/block/block_cipher.h b/src/lib/block/block_cipher.h
index b16468958..7c7084155 100644
--- a/src/lib/block/block_cipher.h
+++ b/src/lib/block/block_cipher.h
@@ -24,14 +24,17 @@ class BOTAN_DLL BlockCipher : public SymmetricAlgorithm
 
       /**
       * Create an instance based on a name
-      * Will return a null pointer if the algo/provider combination cannot
-      * be found. If provider is empty then best available is chosen.
+      * If provider is empty then best available is chosen.
+      * @param algo_spec algorithm name
+      * @param provider provider implementation to choose
+      * @return a null pointer if the algo/provider combination cannot be found
       */
       static std::unique_ptr<BlockCipher> create(const std::string& algo_spec,
                                                  const std::string& provider = "");
 
       /**
-      * Returns the list of available providers for this algorithm, empty if not available
+      * @return list of available providers for this algorithm, empty if not available
+      * @param algo_spec algorithm name
       */
       static std::vector<std::string> providers(const std::string& algo_spec);