From 40efd57757fce12c5059959621e78dd8d06e90bb Mon Sep 17 00:00:00 2001
From: Kris Nuttycombe <kris.nuttycombe@gmail.com>
Date: Tue, 15 Mar 2022 07:47:21 -0600
Subject: [PATCH] Apply suggestions from code review

Co-authored-by: Daira Hopwood <daira@jacaranda.org>
---
 src/bundle.rs | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/bundle.rs b/src/bundle.rs
index 2cc7d508..e6004f45 100644
--- a/src/bundle.rs
+++ b/src/bundle.rs
@@ -365,8 +365,9 @@ impl<T: Authorization, V> Bundle<T, V> {
     }
 
     /// Performs trial decryption of each action in the bundle with each of the
-    /// specified incoming viewing keys, and return the decrypted note contents
-    /// along with the index of the action from which it was derived.
+    /// specified incoming viewing keys, and returns a vector of each decrypted
+    /// note plaintext contents along with the index of the action from which it
+    /// was derived.
     pub fn decrypt_outputs_with_keys(
         &self,
         keys: &[IncomingViewingKey],
@@ -385,7 +386,8 @@ impl<T: Authorization, V> Bundle<T, V> {
     }
 
     /// Performs trial decryption of the action at `action_idx` in the bundle with the
-    /// specified incoming viewing key, and return the decrypted note contents.
+    /// specified incoming viewing key, and returns the decrypted note plaintext
+    /// contents if successful.
     pub fn decrypt_output_with_key(
         &self,
         action_idx: usize,
@@ -398,8 +400,9 @@ impl<T: Authorization, V> Bundle<T, V> {
     }
 
     /// Performs trial decryption of each action in the bundle with each of the
-    /// specified outgoing viewing keys, and return the decrypted note contents
-    /// along with the index of the action from which it was derived.
+    /// specified outgoing viewing keys, and returns a vector of each decrypted
+    /// note plaintext contents along with the index of the action from which it
+    /// was derived.
     pub fn recover_outputs_with_ovks(
         &self,
         keys: &[OutgoingViewingKey],
@@ -424,7 +427,8 @@ impl<T: Authorization, V> Bundle<T, V> {
     }
 
     /// Attempts to decrypt the action at the specified index with the specified
-    /// outgoing viewing key, and return the decrypted note contents.
+    /// outgoing viewing key, and returns the decrypted note plaintext contents
+    /// if successful.
     pub fn recover_output_with_ovk(
         &self,
         action_idx: usize,