Resolve mandoc -Tlint nits

Several of them I have ignored intentionally:

1. unknown manual section comes with the definition;
2. unusual Xr order seems to have been an intentional decision
   grouping by topic rather than alphabetically,
   even if admittedly unusual;
3. no blank before trailing delimiter: Fa extern const
   crypto_argon2_extras crypto_argon2_no_extras;
   is another intentional choice,
   with no reasonable markup existing for a global variable
   declaration other than Bd.

diff --git a/doc/crypto_argon2.3monocypher b/doc/crypto_argon2.3monocypher
index 8f0fb9d0f1ff4f2356d93122e7ed227531c045bb..a05f1eb13dd77049dcbfc48bd0df0c40e774732c 100644 (file)
--- a/doc/crypto_argon2.3monocypher
+++ b/doc/crypto_argon2.3monocypher
@@ -50,7 +50,7 @@
 .\" with this software.  If not, see
 .\" <https://creativecommons.org/publicdomain/zero/1.0/>
 .\"
-.Dd January 22, 2023
+.Dd February 25, 2023
 .Dt CRYPTO_ARGON2 3MONOCYPHER
 .Os
 .Sh NAME
@@ -112,7 +112,7 @@ It must be
 .Fa config.nb_blocks
 × 1024 bytes big and suitably aligned for 64-bit integers.
 If you are not sure how to allocate that buffer, just use
-.Xr malloc 3.
+.Xr malloc 3 .
 .Pp
 The work area is automatically wiped by
 .Fn crypto_argon2 .
@@ -275,7 +275,7 @@ instances in parallel:
 each instance gets a different thread number as additional data,
 generating as many independent digests as we need.
 We can then hash those digests with
-.Xr crypto_blake2b .
+.Xr crypto_blake2b 3monocypher .
 .It Fa ad_size
 Length of
 .Fa ad ,

diff --git a/doc/crypto_blake2b.3monocypher b/doc/crypto_blake2b.3monocypher
index 28b67df17d0d338b0ed3d40b1f85daa0dabc6a48..4ddc79bc3e97bc28c65cf2249e18937df0df5156 100644 (file)
--- a/doc/crypto_blake2b.3monocypher
+++ b/doc/crypto_blake2b.3monocypher
@@ -50,7 +50,7 @@
 .\" with this software.  If not, see
 .\" <https://creativecommons.org/publicdomain/zero/1.0/>
 .\"
-.Dd February 02, 2023
+.Dd February 2, 2023
 .Dt CRYPTO_BLAKE2B 3MONOCYPHER
 .Os
 .Sh NAME

diff --git a/doc/crypto_chacha20_djb.3monocypher b/doc/crypto_chacha20_djb.3monocypher
index 17838e684a1c4340b299019660aeb2542168a969..84bcff2b8cca9b0e9bad7a3f48a0f99853523116 100644 (file)
--- a/doc/crypto_chacha20_djb.3monocypher
+++ b/doc/crypto_chacha20_djb.3monocypher
@@ -10,7 +10,7 @@
 .\"
 .\" Copyright (c) 2017-2019, 2023 Loup Vaillant
 .\" Copyright (c) 2017-2018 Michael Savage
-.\" Copyright (c) 2017, 2019-2021 Fabio Scotoni
+.\" Copyright (c) 2017, 2019-2021, 2023 Fabio Scotoni
 .\" All rights reserved.
 .\"
 .\"
@@ -50,7 +50,7 @@
 .\" with this software.  If not, see
 .\" <https://creativecommons.org/publicdomain/zero/1.0/>
 .\"
-.Dd January 26, 2023
+.Dd February 25, 2023
 .Dt CRYPTO_CHACHA20 3MONOCYPHER
 .Os
 .Sh NAME
@@ -220,7 +220,6 @@ Additionally, it
 .Em can
 be used to generate large amounts of random-looking data quickly
 \(en for example to generate padding.
-.Pp
 .Sh RETURN VALUES
 .Fn crypto_chacha20_djb ,
 .Fn crypto_chacha20_ietf ,
@@ -410,7 +409,7 @@ in
 .Sy undefined behaviour .
 Make sure your inputs are correct.
 .Sh SECURITY CONSIDERATIONS
-.Ss Encrypted does not mean secure .
+.Ss Encrypted does not mean secure
 ChaCha20 only protects against eavesdropping, not forgeries.
 Most applications need protection against forgeries to be properly
 secure.

diff --git a/doc/crypto_ed25519_sign.3monocypher b/doc/crypto_ed25519_sign.3monocypher
index b9c5ab3b5902c6cbab9717b20059a84b4f856d2c..037b159d0dcf8336cd624d7845e0b5e99464686b 100644 (file)
--- a/doc/crypto_ed25519_sign.3monocypher
+++ b/doc/crypto_ed25519_sign.3monocypher
@@ -8,7 +8,7 @@
 .\"
 .\" ----------------------------------------------------------------------------
 .\"
-.\" Copyright (c) 2019-2020, 2022 Fabio Scotoni
+.\" Copyright (c) 2019-2020, 2022-2023 Fabio Scotoni
 .\" All rights reserved.
 .\"
 .\"
@@ -38,7 +38,7 @@
 .\"
 .\" ----------------------------------------------------------------------------
 .\"
-.\" Written in 2019-2020 and 2022 by Fabio Scotoni
+.\" Written in 2019-2020 and 2022-2023 by Fabio Scotoni
 .\"
 .\" To the extent possible under law, the author(s) have dedicated all copyright
 .\" and related neighboring rights to this software to the public domain
@@ -48,14 +48,14 @@
 .\" with this software.  If not, see
 .\" <https://creativecommons.org/publicdomain/zero/1.0/>
 .\"
-.Dd February 13, 2022
+.Dd February 25, 2022
 .Dt CRYPTO_ED25519_SIGN 3MONOCYPHER
 .Os
 .Sh NAME
 .Nm crypto_ed25519_sign ,
 .Nm crypto_ed25519_check ,
-.Nm crypto_ed25519_key_pair
-.Nm crypto_ed25519_ph_sign
+.Nm crypto_ed25519_key_pair ,
+.Nm crypto_ed25519_ph_sign ,
 .Nm crypto_ed25519_ph_check
 .Nd public key signatures
 .Sh SYNOPSIS

diff --git a/doc/crypto_eddsa_sign.3monocypher b/doc/crypto_eddsa_sign.3monocypher
index d661547bd10b222481e7bf4234fb6359e506423a..db2324afd4f3bb8c5094baf8492d379770368ff9 100644 (file)
--- a/doc/crypto_eddsa_sign.3monocypher
+++ b/doc/crypto_eddsa_sign.3monocypher
@@ -10,7 +10,7 @@
 .\"
 .\" Copyright (c) 2017-2019, 2022-2023 Loup Vaillant
 .\" Copyright (c) 2017-2018 Michael Savage
-.\" Copyright (c) 2017, 2019-2022 Fabio Scotoni
+.\" Copyright (c) 2017, 2019-2023 Fabio Scotoni
 .\" All rights reserved.
 .\"
 .\"
@@ -50,18 +50,18 @@
 .\" with this software.  If not, see
 .\" <https://creativecommons.org/publicdomain/zero/1.0/>
 .\"
-.Dd February 19, 2023
+.Dd February 25, 2023
 .Dt CRYPTO_SIGN 3MONOCYPHER
 .Os
 .Sh NAME
-.Nm crypto_eddsa_sign
-.Nm crypto_eddsa_check
-.Nm crypto_eddsa_key_pair
-.Nm crypto_eddsa_to_x25519
-.Nm crypto_eddsa_trim_scalar
-.Nm crypto_eddsa_reduce
-.Nm crypto_eddsa_mul_add
-.Nm crypto_eddsa_scalarbase
+.Nm crypto_eddsa_sign ,
+.Nm crypto_eddsa_check ,
+.Nm crypto_eddsa_key_pair ,
+.Nm crypto_eddsa_to_x25519 ,
+.Nm crypto_eddsa_trim_scalar ,
+.Nm crypto_eddsa_reduce ,
+.Nm crypto_eddsa_mul_add ,
+.Nm crypto_eddsa_scalarbase ,
 .Nm crypto_eddsa_check_equation
 .Nd public key signatures
 .Sh SYNOPSIS
@@ -180,7 +180,6 @@ a key exchange protocol involving
 and then
 .Xr crypto_aead_lock 3monocypher
 instead.
-.Pp
 .Ss Conversion to X25519
 .Fn crypto_eddsa_to_x25519
 Converts and EdDSA public key to an X25519 public key.
@@ -244,11 +243,11 @@ coordinate in Little Endian.
 .Pp
 .Fn crypto_eddsa_check_equation
 reads a signature
-.Fa Rs ,
+.Fa \&Rs ,
 a public_key
 .Fa A ,
 and hash
-.Fa h,
+.Fa h ,
 then checks the following:
 .Bl -dash
 .It

diff --git a/doc/crypto_sha512.3monocypher b/doc/crypto_sha512.3monocypher
index a1a163ce4b6c3481bc71dab064a01158f334c864..ca2ccdd22b49847e8230c5e8f5cbd4178d6fa8bf 100644 (file)
--- a/doc/crypto_sha512.3monocypher
+++ b/doc/crypto_sha512.3monocypher
@@ -8,8 +8,8 @@
 .\"
 .\" ----------------------------------------------------------------------------
 .\"
-.\" Copyright (c) 2019-2020 Fabio Scotoni
-.\" Copyright (c) 2023      Loup Vaillant
+.\" Copyright (c) 2019-2020, 2023 Fabio Scotoni
+.\" Copyright (c) 2023            Loup Vaillant
 .\" All rights reserved.
 .\"
 .\"
@@ -49,7 +49,7 @@
 .\" with this software.  If not, see
 .\" <https://creativecommons.org/publicdomain/zero/1.0/>
 .\"
-.Dd February 5, 2020
+.Dd February 25, 2023
 .Dt CRYPTO_SHA512 3MONOCYPHER
 .Os
 .Sh NAME
@@ -340,7 +340,7 @@ is zero.
 Otherwise it should contain at least 16 bytes.
 .It Fa salt_size
 Length of
-.Fa salt,
+.Fa salt ,
 in bytes.
 .It Fa info
 Optional domain separation string for key derivation.