From b1c463577a447e6194d1b8ff6e382a007df358ec Mon Sep 17 00:00:00 2001
From: "Gary D. Gregory" <ggregory@apache.org>
Date: Thu, 21 Aug 2014 15:27:50 +0000
Subject: [PATCH] Javadoc 8 fixes.

git-svn-id: https://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk@1619439 13f79535-47bb-0310-9956-ffa450edef68
---
 .../http/impl/client/AbstractHttpClient.java  | 45 ++++++++++++-------
 .../http/impl/client/DefaultHttpClient.java   |  2 +-
 .../http/client/utils/URLEncodedUtils.java    |  2 +-
 3 files changed, 32 insertions(+), 17 deletions(-)

diff --git a/httpclient/src/main/java-deprecated/org/apache/http/impl/client/AbstractHttpClient.java b/httpclient/src/main/java-deprecated/org/apache/http/impl/client/AbstractHttpClient.java
index bd4a1b053..a2fe6331b 100644
--- a/httpclient/src/main/java-deprecated/org/apache/http/impl/client/AbstractHttpClient.java
+++ b/httpclient/src/main/java-deprecated/org/apache/http/impl/client/AbstractHttpClient.java
@@ -102,62 +102,77 @@ import org.apache.http.util.Args;
  * of those aspects with custom, application specific ones. This class
  * also provides factory methods to instantiate those objects:
  * <ul>
- *   <li>{@link HttpRequestExecutor}</li> object used to transmit messages
+ *   <li>{@link HttpRequestExecutor} object used to transmit messages
  *    over HTTP connections. The {@link #createRequestExecutor()} must be
  *    implemented by concrete super classes to instantiate this object.
- *   <li>{@link BasicHttpProcessor}</li> object to manage a list of protocol
+ *    </li>
+ *   <li>{@link BasicHttpProcessor} object to manage a list of protocol
  *    interceptors and apply cross-cutting protocol logic to all incoming
  *    and outgoing HTTP messages. The {@link #createHttpProcessor()} must be
  *    implemented by concrete super classes to instantiate this object.
- *   <li>{@link HttpRequestRetryHandler}</li> object used to decide whether
+ *    </li>
+ *   <li>{@link HttpRequestRetryHandler} object used to decide whether
  *    or not a failed HTTP request is safe to retry automatically.
  *    The {@link #createHttpRequestRetryHandler()} must be
  *    implemented by concrete super classes to instantiate this object.
- *   <li>{@link ClientConnectionManager}</li> object used to manage
+ *    </li>
+ *   <li>{@link ClientConnectionManager} object used to manage
  *    persistent HTTP connections.
- *   <li>{@link ConnectionReuseStrategy}</li> object used to decide whether
+ *    </li>
+ *   <li>{@link ConnectionReuseStrategy} object used to decide whether
  *    or not a HTTP connection can be kept alive and re-used for subsequent
  *    HTTP requests. The {@link #createConnectionReuseStrategy()} must be
  *    implemented by concrete super classes to instantiate this object.
- *   <li>{@link ConnectionKeepAliveStrategy}</li> object used to decide how
+ *    </li>
+ *   <li>{@link ConnectionKeepAliveStrategy} object used to decide how
  *    long a persistent HTTP connection can be kept alive.
  *    The {@link #createConnectionKeepAliveStrategy()} must be
  *    implemented by concrete super classes to instantiate this object.
- *   <li>{@link CookieSpecRegistry}</li> object used to maintain a list of
+ *    </li>
+ *   <li>{@link CookieSpecRegistry} object used to maintain a list of
  *    supported cookie specifications.
  *    The {@link #createCookieSpecRegistry()} must be implemented by concrete
  *    super classes to instantiate this object.
- *   <li>{@link CookieStore}</li> object used to maintain a collection of
+ *    </li>
+ *   <li>{@link CookieStore} object used to maintain a collection of
  *    cookies. The {@link #createCookieStore()} must be implemented by
  *    concrete super classes to instantiate this object.
- *   <li>{@link AuthSchemeRegistry}</li> object used to maintain a list of
+ *    </li>
+ *   <li>{@link AuthSchemeRegistry} object used to maintain a list of
  *    supported authentication schemes.
  *    The {@link #createAuthSchemeRegistry()} must be implemented by concrete
  *    super classes to instantiate this object.
- *   <li>{@link CredentialsProvider}</li> object used to maintain
+ *    </li>
+ *   <li>{@link CredentialsProvider} object used to maintain
  *    a collection user credentials. The {@link #createCredentialsProvider()}
  *    must be implemented by concrete super classes to instantiate
  *    this object.
- *   <li>{@link AuthenticationStrategy}</li> object used to authenticate
+ *    </li>
+ *   <li>{@link AuthenticationStrategy} object used to authenticate
  *    against the target host.
  *    The {@link #createTargetAuthenticationStrategy()} must be implemented
  *    by concrete super classes to instantiate this object.
- *   <li>{@link AuthenticationStrategy}</li> object used to authenticate
+ *    </li>
+ *   <li>{@link AuthenticationStrategy} object used to authenticate
  *    against the proxy host.
  *    The {@link #createProxyAuthenticationStrategy()} must be implemented
  *    by concrete super classes to instantiate this object.
- *   <li>{@link HttpRoutePlanner}</li> object used to calculate a route
+ *    </li>
+ *   <li>{@link HttpRoutePlanner} object used to calculate a route
  *    for establishing a connection to the target host. The route
  *    may involve multiple intermediate hops.
  *    The {@link #createHttpRoutePlanner()} must be implemented
  *    by concrete super classes to instantiate this object.
- *   <li>{@link RedirectStrategy}</li> object used to determine if an HTTP
+ *    </li>
+ *   <li>{@link RedirectStrategy} object used to determine if an HTTP
  *    request should be redirected to a new location in response to an HTTP
  *    response received from the target server.
- *   <li>{@link UserTokenHandler}</li> object used to determine if the
+ *    </li>
+ *   <li>{@link UserTokenHandler} object used to determine if the
  *    execution context is user identity specific.
  *    The {@link #createUserTokenHandler()} must be implemented by
  *    concrete super classes to instantiate this object.
+ *    </li>
  * </ul>
  * <p>
  *   This class also maintains a list of protocol interceptors intended
diff --git a/httpclient/src/main/java-deprecated/org/apache/http/impl/client/DefaultHttpClient.java b/httpclient/src/main/java-deprecated/org/apache/http/impl/client/DefaultHttpClient.java
index fa4f900fb..8ef28a408 100644
--- a/httpclient/src/main/java-deprecated/org/apache/http/impl/client/DefaultHttpClient.java
+++ b/httpclient/src/main/java-deprecated/org/apache/http/impl/client/DefaultHttpClient.java
@@ -173,7 +173,7 @@ public class DefaultHttpClient extends AbstractHttpClient {
      * <li>{@link org.apache.http.params.CoreConnectionPNames#SOCKET_BUFFER_SIZE}:
      *   8192</li>
      * <li>{@link org.apache.http.params.CoreProtocolPNames#USER_AGENT}:
-     *   Apache-HttpClient/<release> (java 1.5)</li>
+     *   Apache-HttpClient (Java 1.5)</li>
      * </ul>
      */
     public static void setDefaultHttpParams(final HttpParams params) {
diff --git a/httpclient/src/main/java/org/apache/http/client/utils/URLEncodedUtils.java b/httpclient/src/main/java/org/apache/http/client/utils/URLEncodedUtils.java
index 2870110f5..49576c58a 100644
--- a/httpclient/src/main/java/org/apache/http/client/utils/URLEncodedUtils.java
+++ b/httpclient/src/main/java/org/apache/http/client/utils/URLEncodedUtils.java
@@ -141,7 +141,7 @@ public class URLEncodedUtils {
 
     /**
      * Adds all parameters within the Scanner to the list of {@code parameters}, as encoded by
-     * {@code encoding>. For example, a scanner containing the string {@code a=1&b=2&c=3} would add the
+     * {@code encoding}. For example, a scanner containing the string {@code a=1&b=2&c=3} would add the
      * {@link NameValuePair NameValuePairs} a=1, b=2, and c=3 to the list of parameters. By convention, {@code '&'} and
      * {@code ';'} are accepted as parameter separators.
      *