From 1600e2479be8c7ac5f19cabf69a5e01ba9fee6d3 Mon Sep 17 00:00:00 2001
From: BAE JAE HYEON <roblery128@gmail.com>
Date: Tue, 21 Jul 2026 11:53:49 +0900
Subject: [PATCH 1/2] Fix Javadoc in ProtobufDecoder's MessageSizeReader API
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Previously, the @⁠return tag in MessageSizeReader.readMessageSize() was
followed by a redundant "return", which rendered as "Returns: return
the message size..." in the published API documentation.

Closes gh-37079

Signed-off-by: BAE JAE HYEON <roblery128@gmail.com>
---
 .../springframework/http/codec/protobuf/ProtobufDecoder.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java b/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java
index 8869abfb2f6..daaaf8a6f59 100644
--- a/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java
+++ b/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java
@@ -299,7 +299,7 @@ public class ProtobufDecoder extends ProtobufCodecSupport implements Decoder<Mes
 		/**
 		 * Read the message size from the given buffer. This method may be
 		 * called multiple times before the message size is fully read.
-		 * @return return the message size, or {@code null} if the data in the
+		 * @return the message size, or {@code null} if the data in the
 		 * input buffer was insufficient
 		 */
 		@Nullable Integer readMessageSize(DataBuffer input);

From b90624472e2e9284b216a019f727675cc532b43c Mon Sep 17 00:00:00 2001
From: Sam Brannen <104798+sbrannen@users.noreply.github.com>
Date: Tue, 21 Jul 2026 11:57:20 +0300
Subject: [PATCH 2/2] Polish Javadoc for ProtobufDecoder

---
 .../http/codec/protobuf/ProtobufDecoder.java                | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java b/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java
index daaaf8a6f59..442e255d02c 100644
--- a/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java
+++ b/spring-web/src/main/java/org/springframework/http/codec/protobuf/ProtobufDecoder.java
@@ -47,7 +47,7 @@ import org.springframework.util.MimeType;
  * A {@code Decoder} that reads {@link com.google.protobuf.Message}s using
  * <a href="https://developers.google.com/protocol-buffers/">Google Protocol Buffers</a>.
  *
- * <p>Flux deserialized via
+ * <p>Flux values deserialized via
  * {@link #decode(Publisher, ResolvableType, MimeType, Map)} are expected to use
  * <a href="https://developers.google.com/protocol-buffers/docs/techniques?hl=en#streaming">
  * delimited Protobuf messages</a> with the size of each message specified before
@@ -56,7 +56,7 @@ import org.springframework.util.MimeType;
  * to use regular Protobuf message format (without the size prepended before
  * the message).
  *
- * <p>Notice that default instance of Protobuf message produces empty byte
+ * <p>Notice that the default instance of a Protobuf message produces an empty byte
  * array, so {@code Mono.just(Msg.getDefaultInstance())} sent over the network
  * will be deserialized as an empty {@link Mono}.
  *
@@ -308,7 +308,7 @@ public class ProtobufDecoder extends ProtobufCodecSupport implements Decoder<Mes
 
 	/**
 	 * Default reader for Protobuf messages.
-	 * <p>Parses the message size as a varint from the input stream.
+	 * <p>Parses the message size as a variant from the input stream.
 	 * Inspired by {@link CodedInputStream#readRawVarint32(int, java.io.InputStream)},
 	 * @see <a href="https://developers.google.com/protocol-buffers/docs/encoding#varints">Base 128 Varints</a>
 	 */