From ecb279552f2cbfd5dfd31118ea378152b3e5af6b Mon Sep 17 00:00:00 2001 From: Fabio Scotoni <34964387+fscoto@users.noreply.github.com> Date: Thu, 5 Dec 2019 08:54:58 +0100 Subject: [PATCH] Documentation: Get rid of "we" for more neutral style --- doc/man/man3/crypto_argon2i.3monocypher | 4 ++-- doc/man/man3/crypto_blake2b.3monocypher | 6 +++--- doc/man/man3/optional/crypto_hmac_sha512.3monocypher | 6 +++--- doc/man/man3/optional/crypto_sha512.3monocypher | 6 +++--- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/man/man3/crypto_argon2i.3monocypher b/doc/man/man3/crypto_argon2i.3monocypher index 7e38448..2374590 100644 --- a/doc/man/man3/crypto_argon2i.3monocypher +++ b/doc/man/man3/crypto_argon2i.3monocypher @@ -124,8 +124,8 @@ and .Fa nb_iterations parameters, it should first be decided how long the computation should take. -For user authentication, we recommend somewhere between half a second -(convenient) and several seconds (paranoid). +For user authentication, values somewhere between half a second +(convenient) and several seconds (paranoid) are recommended. The computation should use as much memory as can be spared. .Pp Since parameter selection depends on your hardware, some trial and error diff --git a/doc/man/man3/crypto_blake2b.3monocypher b/doc/man/man3/crypto_blake2b.3monocypher index 710aef4..a328d2a 100644 --- a/doc/man/man3/crypto_blake2b.3monocypher +++ b/doc/man/man3/crypto_blake2b.3monocypher @@ -132,16 +132,16 @@ initialisation with .Fn crypto_blake2b_general_init or .Fn crypto_blake2b_init , -where we set up a context with the hashing parameters; +which sets up a context with the hashing parameters; .It update with .Fn crypto_blake2b_update , -where we hash the message chunk by chunk, and keep the intermediary +which hashes the message chunk by chunk, and keep the intermediary result in the context; .It and finalisation with .Fn crypto_blake2b_final , -where we produce the final hash. +which produces the final hash. The .Ft crypto_blake2b_ctx is automatically wiped upon finalisation. diff --git a/doc/man/man3/optional/crypto_hmac_sha512.3monocypher b/doc/man/man3/optional/crypto_hmac_sha512.3monocypher index 003c519..d96eb9b 100644 --- a/doc/man/man3/optional/crypto_hmac_sha512.3monocypher +++ b/doc/man/man3/optional/crypto_hmac_sha512.3monocypher @@ -84,16 +84,16 @@ This interface uses three steps: .It initialisation with .Fn crypto_hmac_sha512_init , -where we set up a context with the hashing parameters; +which sets up a context with the hashing parameters; .It update with .Fn crypto_hmac_sha512_update , -where we hash the message chunk by chunk, and keep the intermediary +which hashes the message chunk by chunk, and keep the intermediary result in the context; .It and finalisation with .Fn crypto_hmac_sha512_final , -where we produce the final hash. +which produces the final hash. The .Ft crypto_hmac_sha512_ctx is automatically wiped upon finalisation. diff --git a/doc/man/man3/optional/crypto_sha512.3monocypher b/doc/man/man3/optional/crypto_sha512.3monocypher index 6588531..5a61624 100644 --- a/doc/man/man3/optional/crypto_sha512.3monocypher +++ b/doc/man/man3/optional/crypto_sha512.3monocypher @@ -78,16 +78,16 @@ This interface uses three steps: .It initialisation with .Fn crypto_sha512_init , -where we set up a context with the hashing parameters; +which sets up a context with the hashing parameters; .It update with .Fn crypto_sha512_update , -where we hash the message chunk by chunk, and keep the intermediary +which hashes the message chunk by chunk, and keep the intermediary result in the context; .It and finalisation with .Fn crypto_sha512_final , -where we produce the final hash. +which produces the final hash. The .Ft crypto_sha512_ctx is automatically wiped upon finalisation. -- 2.47.3