Fix some Doxygen errors

5 files changed, 18 insertions, 1 deletions

diff --git a/src/build-data/botan.doxy.in b/src/build-data/botan.doxy.in
index 4065ad7a1..11315a5c4 100644
--- a/src/build-data/botan.doxy.in
+++ b/src/build-data/botan.doxy.in
@@ -152,6 +152,7 @@ INCLUDE_FILE_PATTERNS  =
 PREDEFINED             = BOTAN_HAS_AES_SSSE3 \
                          BOTAN_HAS_AES_NI \
                          BOTAN_HAS_AES_ARMV8 \
+                         BOTAN_HAS_AES_POWER8 \
                          BOTAN_HAS_IDEA_SSE2 \
                          BOTAN_HAS_NOEKEON_SIMD \
                          BOTAN_HAS_SERPENT_SIMD \
diff --git a/src/lib/math/bigint/bigint.h b/src/lib/math/bigint/bigint.h
index 3d6626e4d..cb518e727 100644
--- a/src/lib/math/bigint/bigint.h
+++ b/src/lib/math/bigint/bigint.h
@@ -253,7 +253,8 @@ class BOTAN_PUBLIC_API(2,0) BigInt final
 
      /**
      * Set *this to y - *this
-     * @param y the BigInt to subtract from
+     * @param y the BigInt to subtract from as a sequence of words
+     * @param y_size length of y in words
      * @param ws a temp workspace
      */
      BigInt& rev_sub(const word y[], size_t y_size, secure_vector<word>& ws);
diff --git a/src/lib/math/mp/mp_core.h b/src/lib/math/mp/mp_core.h
index 514240197..a2c39bafa 100644
--- a/src/lib/math/mp/mp_core.h
+++ b/src/lib/math/mp/mp_core.h
@@ -125,6 +125,7 @@ void bigint_linmul3(word z[], const word x[], size_t x_size, word y);
 * @param p_size size of p
 * @param p_dash Montgomery value
 * @param workspace array of at least 2*(p_size+1) words
+* @param ws_size size of workspace in words
 */
 void bigint_monty_redc(word z[],
                        const word p[], size_t p_size,
diff --git a/src/lib/misc/fpe_fe1/fpe_fe1.h b/src/lib/misc/fpe_fe1/fpe_fe1.h
index e823a5d3c..d9f760f0d 100644
--- a/src/lib/misc/fpe_fe1/fpe_fe1.h
+++ b/src/lib/misc/fpe_fe1/fpe_fe1.h
@@ -50,6 +50,7 @@ class BOTAN_PUBLIC_API(2,5) FPE_FE1 final : public SymmetricAlgorithm
       * Encrypt X from and onto the group Z_n using key and tweak
       * @param x the plaintext to encrypt <= n
       * @param tweak will modify the ciphertext
+      * @param tweak_len length of tweak
       */
       BigInt encrypt(const BigInt& x, const uint8_t tweak[], size_t tweak_len) const;
 
@@ -57,6 +58,7 @@ class BOTAN_PUBLIC_API(2,5) FPE_FE1 final : public SymmetricAlgorithm
       * Decrypt X from and onto the group Z_n using key and tweak
       * @param x the ciphertext to encrypt <= n
       * @param tweak must match the value used to encrypt
+      * @param tweak_len length of tweak
       */
       BigInt decrypt(const BigInt& x, const uint8_t tweak[], size_t tweak_len) const;
 
diff --git a/src/lib/pubkey/ec_group/point_gfp.h b/src/lib/pubkey/ec_group/point_gfp.h
index 80c198c62..2a9948fde 100644
--- a/src/lib/pubkey/ec_group/point_gfp.h
+++ b/src/lib/pubkey/ec_group/point_gfp.h
@@ -204,6 +204,7 @@ class BOTAN_PUBLIC_API(2,0) PointGFp final
 
       /**
       * Point addition
+      * @param other the point to add to *this
       * @param workspace temp space, at least WORKSPACE_SIZE elements
       */
       void add(const PointGFp& other, std::vector<BigInt>& workspace);
@@ -215,6 +216,15 @@ class BOTAN_PUBLIC_API(2,0) PointGFp final
       */
       void add_affine(const PointGFp& other, std::vector<BigInt>& workspace);
 
+      /**
+      * Point addition - mixed J+A. Array version.
+      *
+      * @param x_words the words of the x coordinate of the other point
+      * @param x_size size of x_words
+      * @param y_words the words of the y coordinate of the other point
+      * @param y_size size of y_words
+      * @param workspace temp space, at least WORKSPACE_SIZE elements
+      */
       void add_affine(const word x_words[], size_t x_size,
                       const word y_words[], size_t y_size,
                       std::vector<BigInt>& workspace);
@@ -227,7 +237,9 @@ class BOTAN_PUBLIC_API(2,0) PointGFp final
 
       /**
       * Point addition
+      * @param other the point to add to *this
       * @param workspace temp space, at least WORKSPACE_SIZE elements
+      * @return other plus *this
       */
       PointGFp plus(const PointGFp& other, std::vector<BigInt>& workspace) const
          {