From a599638ce2a0c7ad534ceae98bbcf30f50f40233 Mon Sep 17 00:00:00 2001
From: larabr <larabr@protonmail.com>
Date: Thu, 19 Aug 2021 17:58:52 +0200
Subject: [PATCH] Docs: clarify content of returned `signatures` value in
 `openpgp.verify` and `decrypt`

---
 src/message.js | 2 +-
 src/openpgp.js | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/message.js b/src/message.js
index 628f8bf6..94ba9c1a 100644
--- a/src/message.js
+++ b/src/message.js
@@ -768,7 +768,7 @@ async function createVerificationObject(signature, literalDataList, verification
  *   keyID: module:type/keyid~KeyID,
  *   signature: Promise<Signature>,
  *   verified: Promise<true>
- * }>>} list of signer's keyID and validity of signatures
+ * }>>} list of signer's keyID and validity of signatures (one entry per signature packet in input)
  * @async
  * @private
  */
diff --git a/src/openpgp.js b/src/openpgp.js
index a77739c1..7a6f3048 100644
--- a/src/openpgp.js
+++ b/src/openpgp.js
@@ -324,6 +324,8 @@ export async function encrypt({ message, encryptionKeys, signingKeys, passwords,
  *         }, ...
  *       ]
  *     }
+ *
+ *     where `signatures` contains a separate entry for each signature packet found in the input message.
  * @async
  * @static
  */
@@ -453,6 +455,8 @@ export async function sign({ message, signingKeys, format = 'armored', detached
  *         }, ...
  *       ]
  *     }
+ *
+ *     where `signatures` contains a separate entry for each signature packet found in the input message.
  * @async
  * @static
  */