psa: Document generator requirements consistently
We've added documentation for how context objects for multi-part
operations must be initialized consistently for key policy, hash,
cipher, and MAC. Update the generator documentation to be consistent
with how we've documented the other operations.
diff --git a/include/psa/crypto.h b/include/psa/crypto.h
index c266f9f..683feb8 100644
--- a/include/psa/crypto.h
+++ b/include/psa/crypto.h
@@ -2099,11 +2099,9 @@
* - For HKDF (#PSA_ALG_HKDF), \p salt is the salt used in the "extract" step
* and \p label is the info string used in the "expand" step.
*
- * \param[in,out] generator The generator object to set up. It must
- * have been initialized to all-bits-zero,
- * a logical zero (`{0}`),
- * \c PSA_CRYPTO_GENERATOR_INIT or
- * psa_crypto_generator_init().
+ * \param[in,out] generator The generator object to set up. It must have
+ * been initialized as per the documentation for
+ * #psa_crypto_generator_t and not yet in use.
* \param handle Handle to the secret key.
* \param alg The key derivation algorithm to compute
* (\c PSA_ALG_XXX value such that
@@ -2153,11 +2151,9 @@
* The resulting generator always has the maximum capacity permitted by
* the algorithm.
*
- * \param[in,out] generator The generator object to set up. It must
- * have been initialized to all-bits-zero,
- * a logical zero (`{0}`),
- * \c PSA_CRYPTO_GENERATOR_INIT or
- * psa_crypto_generator_init().
+ * \param[in,out] generator The generator object to set up. It must have
+ * been initialized as per the documentation for
+ * #psa_crypto_generator_t and not yet in use.
* \param private_key Handle to the private key to use.
* \param[in] peer_key Public key of the peer. It must be
* in the same format that psa_import_key()