m doc improvement

Signed-off-by: Mattias Andrée <maandree@kth.se>

6 files changed, 36 insertions, 6 deletions

diff --git a/libhashsum_init_rawshake128_hasher.3 b/libhashsum_init_rawshake128_hasher.3
index 178a03b..26ec70c 100644
--- a/libhashsum_init_rawshake128_hasher.3
+++ b/libhashsum_init_rawshake128_hasher.3
@@ -63,7 +63,12 @@ will point to a buffer in
 will be set to the block size RawSHAKE128 uses, in bytes.
 .PP
 .I hasher->hash_size
-will be set to the size of RawSHAKE128 hashes, in bytes
+will be set to the hash size, in bytes, which is
+.I (hashbits+7)/8
+unless
+.IR hashbits==0 ,
+and 128 if
+.I hashbits==0
 .RI ( LIBHASHSUM_RAWSHAKE128_HASH_SIZE
 if
 .I hashbits
diff --git a/libhashsum_init_rawshake256_hasher.3 b/libhashsum_init_rawshake256_hasher.3
index f24b6e1..ad37c27 100644
--- a/libhashsum_init_rawshake256_hasher.3
+++ b/libhashsum_init_rawshake256_hasher.3
@@ -63,7 +63,12 @@ will point to a buffer in
 will be set to the block size RawSHAKE256 uses, in bytes.
 .PP
 .I hasher->hash_size
-will be set to the size of RawSHAKE256 hashes, in bytes
+will be set to the hash size, in bytes, which is
+.I (hashbits+7)/8
+unless
+.IR hashbits==0 ,
+and 256 if
+.I hashbits==0
 .RI ( LIBHASHSUM_RAWSHAKE256_HASH_SIZE
 if
 .I hashbits
diff --git a/libhashsum_init_rawshake512_hasher.3 b/libhashsum_init_rawshake512_hasher.3
index 04da5c4..bef15c0 100644
--- a/libhashsum_init_rawshake512_hasher.3
+++ b/libhashsum_init_rawshake512_hasher.3
@@ -63,7 +63,12 @@ will point to a buffer in
 will be set to the block size RawSHAKE512 uses, in bytes.
 .PP
 .I hasher->hash_size
-will be set to the size of RawSHAKE512 hashes, in bytes
+will be set to the hash size, in bytes, which is
+.I (hashbits+7)/8
+unless
+.IR hashbits==0 ,
+and 512 if
+.I hashbits==0
 .RI ( LIBHASHSUM_RAWSHAKE512_HASH_SIZE
 if
 .I hashbits
diff --git a/libhashsum_init_shake128_hasher.3 b/libhashsum_init_shake128_hasher.3
index f852491..160b82d 100644
--- a/libhashsum_init_shake128_hasher.3
+++ b/libhashsum_init_shake128_hasher.3
@@ -63,7 +63,12 @@ will point to a buffer in
 will be set to the block size SHAKE128 uses, in bytes.
 .PP
 .I hasher->hash_size
-will be set to the size of SHAKE128 hashes, in bytes
+will be set to the hash size, in bytes, which is
+.I (hashbits+7)/8
+unless
+.IR hashbits==0 ,
+and 128 if
+.I hashbits==0
 .RI ( LIBHASHSUM_SHAKE128_HASH_SIZE
 if
 .I hashbits
diff --git a/libhashsum_init_shake256_hasher.3 b/libhashsum_init_shake256_hasher.3
index 972e68e..a38f405 100644
--- a/libhashsum_init_shake256_hasher.3
+++ b/libhashsum_init_shake256_hasher.3
@@ -63,7 +63,12 @@ will point to a buffer in
 will be set to the block size SHAKE256 uses, in bytes.
 .PP
 .I hasher->hash_size
-will be set to the size of SHAKE256 hashes, in bytes
+will be set to the hash size, in bytes, which is
+.I (hashbits+7)/8
+unless
+.IR hashbits==0 ,
+and 256 if
+.I hashbits==0
 .RI ( LIBHASHSUM_SHAKE256_HASH_SIZE
 if
 .I hashbits
diff --git a/libhashsum_init_shake512_hasher.3 b/libhashsum_init_shake512_hasher.3
index 074ec2c..22630e2 100644
--- a/libhashsum_init_shake512_hasher.3
+++ b/libhashsum_init_shake512_hasher.3
@@ -63,7 +63,12 @@ will point to a buffer in
 will be set to the block size SHAKE512 uses, in bytes.
 .PP
 .I hasher->hash_size
-will be set to the size of SHAKE512 hashes, in bytes
+will be set to the hash size, in bytes, which is
+.I (hashbits+7)/8
+unless
+.IR hashbits==0 ,
+and 512 if
+.I hashbits==0
 .RI ( LIBHASHSUM_SHAKE512_HASH_SIZE
 if
 .I hashbits