RFR [11] 8207265: Bad HTML in {@link} in HttpResponse.BodySubscribers.ofPublisher

Chris Hegarty chris.hegarty at oracle.com
Mon Jul 16 11:10:12 UTC 2018


This is a review request for a small doc-only change to fix a
"bad" use of angle brackets ( for a parameterized type ) as
the target of an @link [*]. The simplest solution is to just
replace the link with @code, since the built javadoc contains
the appropriate links in the method declaration.


diff --git 
a/src/java.net.http/share/classes/java/net/http/HttpResponse.java 
b/src/java.net.http/share/classes/java/net/http/HttpResponse.java
--- a/src/java.net.http/share/classes/java/net/http/HttpResponse.java
+++ b/src/java.net.http/share/classes/java/net/http/HttpResponse.java
@@ -1188,7 +1188,7 @@

          /**
           * Returns a response subscriber which publishes the response body
-         * through a {@link Publisher Publisher<List<ByteBuffer>>}.
+         * through a {@code Publisher<List<ByteBuffer>>}.
           *
           * <p> The {@link HttpResponse} using this subscriber is available
           * immediately after the response headers have been read, without


-Chris.

[*] https://bugs.openjdk.java.net/browse/JDK-8207265


More information about the net-dev mailing list