Javadoc improvements

- Fix @link tags.
- Fix @SInCE tag.
- Add missing @throws tags.
- Add missing @param tags for generics.
- Add missing @return tags.
- Sentences end in a period.
- Fix typos.

Author: garydgregory

httpcore5-h2/src/main/java/org/apache/hc/core5/http2/impl/nio/FrameInputBuffer.java

@@ -101,9 +101,8 @@ public void put(final ByteBuffer src) {
      *
      * @param src the source buffer or {@code null} if not available.
      * @param channel the underlying data channel.
-     *
      * @return a complete frame or {@code null} a complete frame cannot be read.
-     *
+     * @throws IOException in case of an I/O error.
      * @since 5.1
      */
     public RawFrame read(final ByteBuffer src, final ReadableByteChannel channel) throws IOException {
@@ -190,6 +189,8 @@ public RawFrame read(final ByteBuffer src, final ReadableByteChannel channel) th
      * Attempts to read a complete frame from the underlying data channel.
      *
      * @param channel the underlying data channel.
+     * @return a complete frame or {@code null} a complete frame cannot be read.
+     * @throws IOException in case of an I/O error.
      */
     public RawFrame read(final ReadableByteChannel channel) throws IOException {
         return read(null, channel);

httpcore5-h2/src/main/java/org/apache/hc/core5/http2/impl/nio/bootstrap/H2MultiplexingRequester.java

@@ -264,6 +264,7 @@ public void cancelled() {
     }
 
     /**
+     * @param <T> The result type returned by the Future's {@code get} method.
      * @since 5.3
      */
     public final <T> Future<T> execute(
@@ -304,6 +305,7 @@ public final <T> Future<T> execute(
     }
 
     /**
+     * @param <T> The result type returned by the Future's {@code get} method.
      * @since 5.3
      */
     public final <T> Future<T> execute(

httpcore5-h2/src/main/java/org/apache/hc/core5/http2/impl/nio/bootstrap/H2RequesterBootstrap.java

@@ -324,6 +324,7 @@ public final H2RequesterBootstrap register(final String hostname, final String u
     }
 
     /**
+     * @return this instance.
      * @deprecated Use {@link #register(String, String, Supplier)}.
      */
     @Deprecated

httpcore5-h2/src/main/java/org/apache/hc/core5/http2/impl/nio/bootstrap/H2ServerBootstrap.java

@@ -317,6 +317,7 @@ public final H2ServerBootstrap registerVirtual(final String hostname, final Stri
      * Registers the given {@link AsyncServerRequestHandler} as a default handler for URIs
      * matching the given pattern.
      *
+     * @param <T> request handler representation.
      * @param uriPattern the pattern to register the handler for.
      * @param requestHandler the handler.
      * @return this instance.
@@ -332,6 +333,7 @@ public final <T> H2ServerBootstrap register(
      * Registers the given {@link AsyncServerRequestHandler} as a handler for URIs
      * matching the given host and the pattern.
      *
+     * @param <T> request handler representation.
      * @param hostname the host name
      * @param uriPattern the pattern to register the handler for.
      * @param requestHandler the handler.
@@ -348,6 +350,7 @@ public final <T> H2ServerBootstrap register(
     }
 
     /**
+     * @param <T> request handler representation.
      * @return this instance.
      * @deprecated Use {@link #register(String, String, Supplier)}.
      */
@@ -361,6 +364,8 @@ public final <T> H2ServerBootstrap registerVirtual(
 
     /**
      * Adds the filter before the filter with the given name.
+     *
+     * @return this instance.
      */
     public final H2ServerBootstrap addFilterBefore(final String existing, final String name, final AsyncFilterHandler filterHandler) {
         Args.notBlank(existing, "Existing");

httpcore5-h2/src/main/java/org/apache/hc/core5/http2/nio/AsyncPingHandler.java

@@ -49,6 +49,8 @@ public interface AsyncPingHandler {
      * Triggered to signal receipt of a ping response message.
      *
      * @param feedback the ping message feedback.
+     * @throws HttpException in case of HTTP protocol violation.
+     * @throws IOException in case of an I/O error.
      */
     void consumeResponse(ByteBuffer feedback) throws HttpException, IOException;
 

httpcore5-h2/src/main/java/org/apache/hc/core5/http2/ssl/H2TlsSupport.java

@@ -68,6 +68,7 @@ public static String[] selectApplicationProtocols(final Object attachment) {
     }
 
     /**
+     * @return the given SSLParameters.
      * @since 5.3
      */
     public static SSLParameters enforceRequirements(

httpcore5-reactive/src/main/java/org/apache/hc/core5/reactive/ReactiveRequestProcessor.java

@@ -54,6 +54,8 @@ public interface ReactiveRequestProcessor {
      * @param context the actual execution context.
      * @param requestBody a reactive stream representing the request body.
      * @param responseBodyCallback a callback to invoke with the response body, if any.
+     * @throws HttpException in case of HTTP protocol violation.
+     * @throws IOException in case of an I/O error.
      */
     void processRequest(
             HttpRequest request,

httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/BasicDataStreamChannel.java

@@ -36,6 +36,9 @@
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * Writes to a byte stream channel.
+ */
 public class BasicDataStreamChannel implements DataStreamChannel {
 
     private final WritableByteChannel byteChannel;

httpcore5-testing/src/test/java/org/apache/hc/core5/testing/nio/MessageExchangeHandler.java

@@ -38,6 +38,7 @@
 import org.apache.hc.core5.http.protocol.HttpContext;
 
 /**
+ * @param <T> The message body type.
  * @since 5.0
  */
 public abstract class MessageExchangeHandler<T> extends AbstractServerExchangeHandler<Message<HttpRequest, T>> {

httpcore5/src/main/java/org/apache/hc/core5/concurrent/FutureCallback.java

@@ -27,8 +27,7 @@
 package org.apache.hc.core5.concurrent;
 
 /**
- * A callback interface that gets invoked upon completion of
- * a {@link concurrent.Future}.
+ * A callback interface that gets invoked upon completion of a {@link java.util.concurrent.Future}.
  *
  * @param <T> the future result type returned by this callback.
  * @since 4.2