Improve documentation of signing-related API

Author: Martchus

misc/signingkeys.h

@@ -17,8 +17,8 @@ namespace CppUtilities {
  * - The concrete type of the contained key variables will change when the number of keys changes.
  *   So do *not* use it in e.g. a function signature or member variable that will become part of
  *   some public API/ABI. The variable is mereley supposed to be passed to verifySignature().
- * - This function is experimental and might be changed in incompatible ways (API and ABI wise) or be completely removed
- *   in further minor/patch releases.
+ * - This namespace is experimental and its members might be changed in incompatible ways (API and ABI
+ *   wise) or be completely removed in further minor/patch releases.
  */
 namespace SigningKeys {
 

misc/verification.h

@@ -51,7 +51,7 @@ inline std::string extractPemBody(std::string_view pem, std::string_view header)
     return body;
 }
 
-/// \brief Converts PEM-encoded signature into DER-encoded signature.
+/// \brief Converts a PEM-encoded signature into a DER-encoded signature.
 /// \remarks This function is an implementation detail and must not be called by users of this library.
 inline std::string parsePemSignature(std::string_view pemSignature, std::pair<std::unique_ptr<std::uint8_t[]>, std::uint32_t> &decodedSignature)
 {