-clarify docs

2 files changed, 4 insertions, 2 deletions

diff --git a/src/include/gnunet_crypto_lib.h b/src/include/gnunet_crypto_lib.h
index 0710815b5..21f28370e 100644
--- a/src/include/gnunet_crypto_lib.h
+++ b/src/include/gnunet_crypto_lib.h
@@ -371,7 +371,8 @@ struct GNUNET_CRYPTO_PaillierPrivateKey
 struct GNUNET_CRYPTO_PaillierCiphertext
 {
   /**
-   * guaranteed minimum number of homomorphic operations with this ciphertext
+   * Guaranteed minimum number of homomorphic operations with this ciphertext,
+   * in network byte order (NBO).
    */
   int32_t remaining_ops GNUNET_PACKED;
 
diff --git a/src/scalarproduct/gnunet-service-scalarproduct.h b/src/scalarproduct/gnunet-service-scalarproduct.h
index f0c3fa22d..2d4d40353 100644
--- a/src/scalarproduct/gnunet-service-scalarproduct.h
+++ b/src/scalarproduct/gnunet-service-scalarproduct.h
@@ -131,7 +131,8 @@ struct BobCryptodataMultipartMessage
   uint32_t contained_element_count GNUNET_PACKED;
 
   /**
-   * struct GNUNET_CRYPTO_PaillierCiphertext[multipart_element_count]
+   * Followed by `struct
+   * GNUNET_CRYPTO_PaillierCiphertext[contained_element_count]`
    */
 };