Javadoc

- Add generic type documentation
- Add parameter documentation

httpclient5/src/main/java/org/apache/hc/client5/http/AbstractClientContextBuilder.java

@@ -48,6 +48,7 @@ import org.apache.hc.core5.util.Args;
 /**
  * Abstract {@link HttpClientContext} builder.
  *
+ * @param <T> The HttpClientContext type or subtype.
  * @since 5.4
  */
 public abstract class AbstractClientContextBuilder<T extends HttpClientContext> {

httpclient5/src/main/java/org/apache/hc/client5/http/ConnectTimeoutException.java

@@ -44,6 +44,8 @@ public class ConnectTimeoutException extends SocketTimeoutException {
 
     /**
      * Creates a ConnectTimeoutException with the specified detail message.
+     *
+     * @param message The detail message (which is saved for later retrieval by the {@link #getMessage()} method).
      */
     public ConnectTimeoutException(final String message) {
         super(message);
@@ -56,6 +58,9 @@ public class ConnectTimeoutException extends SocketTimeoutException {
     }
 
     /**
+     * Gets the named endpoint.
+     *
+     * @return the named endpoint, may be {@code null}.
      * @since 5.0
      */
     public NamedEndpoint getHost() {

httpclient5/src/main/java/org/apache/hc/client5/http/UnsupportedSchemeException.java

@@ -40,6 +40,8 @@ public class UnsupportedSchemeException extends IOException {
 
     /**
      * Creates a UnsupportedSchemeException with the specified detail message.
+     *
+     * @param message The detail message (which is saved for later retrieval by the {@link #getMessage()} method).
      */
     public UnsupportedSchemeException(final String message) {
         super(message);