From cd3ddd81731650b99f3d8e9db6f5a1d37b6ff2b8 Mon Sep 17 00:00:00 2001
From: Michael Rosenberg <michael@mrosenberg.pub>
Date: Fri, 10 May 2024 12:37:04 +0200
Subject: [PATCH] Tightened wording

---
 ed25519-dalek/src/verifying.rs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/ed25519-dalek/src/verifying.rs b/ed25519-dalek/src/verifying.rs
index 22321b84e..34865abe9 100644
--- a/ed25519-dalek/src/verifying.rs
+++ b/ed25519-dalek/src/verifying.rs
@@ -148,8 +148,9 @@ impl VerifyingKey {
     ///
     /// # Returns
     ///
-    /// A `Result` whose okay value is an EdDSA `VerifyingKey` or a decompression error if the
-    /// provided bytes do not represent the \\(y\\)-coordinate of a curve point.
+    /// On success, returns an EdDSA `VerifyingKey`. Returns a decompression error if the provided
+    /// bytes are not a valid verifying key, i.e., do not represent the \\(y\\)-coordinate of a
+    /// curve point.
     #[inline]
     pub fn from_bytes(bytes: &[u8; PUBLIC_KEY_LENGTH]) -> Result<VerifyingKey, SignatureError> {
         let compressed = CompressedEdwardsY(*bytes);