From ad606e45bf4dabf6d347db3ced83a88f9f3b407b Mon Sep 17 00:00:00 2001
From: Gary Gregory <garydgregory@gmail.com>
Date: Wed, 4 Oct 2017 15:00:20 -0600
Subject: [PATCH] Javadoc.

---
 .../http/client/entity/EntityBuilder.java     | 111 ++++++++++--------
 1 file changed, 64 insertions(+), 47 deletions(-)

diff --git a/httpclient/src/main/java/org/apache/http/client/entity/EntityBuilder.java b/httpclient/src/main/java/org/apache/http/client/entity/EntityBuilder.java
index 3c966785c..34a2c4edc 100644
--- a/httpclient/src/main/java/org/apache/http/client/entity/EntityBuilder.java
+++ b/httpclient/src/main/java/org/apache/http/client/entity/EntityBuilder.java
@@ -100,13 +100,15 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a string. This method is mutually exclusive with
-     * {@link #setBinary(byte[])},
-     * {@link #setStream(java.io.InputStream)} ,
-     * {@link #setSerializable(java.io.Serializable)} ,
-     * {@link #setParameters(java.util.List)},
-     * {@link #setParameters(org.apache.http.NameValuePair...)}
-     * {@link #setFile(java.io.File)} methods.
+     * Sets entity content as a string. This method is mutually exclusive with:
+     * <ul>
+     * <li>{@link #setBinary(byte[])}</li>
+     * <li>{@link #setStream(java.io.InputStream)}</li>
+     * <li>{@link #setSerializable(java.io.Serializable)}</li>
+     * <li>{@link #setParameters(java.util.List)}</li>
+     * <li>{@link #setParameters(org.apache.http.NameValuePair...)}</li>
+     * <li>{@link #setFile(java.io.File)}</li>
+     * <ul>
      */
     public EntityBuilder setText(final String text) {
         clearContent();
@@ -123,13 +125,16 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a byte array. This method is mutually exclusive with
-     * {@link #setText(String)},
-     * {@link #setStream(java.io.InputStream)} ,
-     * {@link #setSerializable(java.io.Serializable)} ,
-     * {@link #setParameters(java.util.List)},
-     * {@link #setParameters(org.apache.http.NameValuePair...)}
-     * {@link #setFile(java.io.File)} methods.
+     * Sets entity content as a byte array. This method is mutually exclusive
+     * with:
+     * <ul>
+     * <li>{@link #setText(String)}</li>
+     * <li>{@link #setStream(java.io.InputStream)}</li>
+     * <li>{@link #setSerializable(java.io.Serializable)}</li>
+     * <li>{@link #setParameters(java.util.List)}</li>
+     * <li>{@link #setParameters(org.apache.http.NameValuePair...)}</li>
+     * <li>{@link #setFile(java.io.File)}</li>
+     * </ul>
      */
     public EntityBuilder setBinary(final byte[] binary) {
         clearContent();
@@ -146,13 +151,16 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a {@link InputStream}. This method is mutually exclusive with
-     * {@link #setText(String)},
-     * {@link #setBinary(byte[])},
-     * {@link #setSerializable(java.io.Serializable)} ,
-     * {@link #setParameters(java.util.List)},
-     * {@link #setParameters(org.apache.http.NameValuePair...)}
-     * {@link #setFile(java.io.File)} methods.
+     * Sets entity content as a {@link InputStream}. This method is mutually
+     * exclusive with:
+     * <ul>
+     * <li>{@link #setText(String)}</li>
+     * <li>{@link #setBinary(byte[])}</li>
+     * <li>{@link #setSerializable(java.io.Serializable)}</li>
+     * <li>{@link #setParameters(java.util.List)}</li>
+     * <li>{@link #setParameters(org.apache.http.NameValuePair...)}</li>
+     * <li>{@link #setFile(java.io.File)}</li>
+     * </ul>
      */
     public EntityBuilder setStream(final InputStream stream) {
         clearContent();
@@ -170,12 +178,15 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a parameter list. This method is mutually exclusive with
-     * {@link #setText(String)},
-     * {@link #setBinary(byte[])},
-     * {@link #setStream(java.io.InputStream)} ,
-     * {@link #setSerializable(java.io.Serializable)} ,
-     * {@link #setFile(java.io.File)} methods.
+     * Sets entity content as a parameter list. This method is mutually
+     * exclusive with:
+     * <ul>
+     * <li>{@link #setText(String)}</li>
+     * <li>{@link #setBinary(byte[])}</li>
+     * <li>{@link #setStream(java.io.InputStream)}</li>
+     * <li>{@link #setSerializable(java.io.Serializable)}</li>
+     * <li>{@link #setFile(java.io.File)}</li>
+     * </ul>
      */
     public EntityBuilder setParameters(final List<NameValuePair> parameters) {
         clearContent();
@@ -184,12 +195,14 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a parameter list. This method is mutually exclusive with
-     * {@link #setText(String)},
-     * {@link #setBinary(byte[])},
-     * {@link #setStream(java.io.InputStream)} ,
-     * {@link #setSerializable(java.io.Serializable)} ,
-     * {@link #setFile(java.io.File)} methods.
+     * Sets entity content as a parameter list. This method is mutually exclusive with:
+     * <ul>
+     * <li>{@link #setText(String)}</li>
+     * <li>{@link #setBinary(byte[])}</li>
+     * <li>{@link #setStream(java.io.InputStream)}</li>
+     * <li>{@link #setSerializable(java.io.Serializable)}</li>
+     * <li>{@link #setFile(java.io.File)}</li>
+     * </ul>
      */
     public EntityBuilder setParameters(final NameValuePair... parameters) {
         return setParameters(Arrays.asList(parameters));
@@ -204,13 +217,15 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a {@link Serializable}. This method is mutually exclusive with
-     * {@link #setText(String)},
-     * {@link #setBinary(byte[])},
-     * {@link #setStream(java.io.InputStream)} ,
-     * {@link #setParameters(java.util.List)},
-     * {@link #setParameters(org.apache.http.NameValuePair...)}
-     * {@link #setFile(java.io.File)} methods.
+     * Sets entity content as a {@link Serializable}. This method is mutually exclusive with:
+     * <ul>
+     * <li>{@link #setText(String)}</li>
+     * <li>{@link #setBinary(byte[])}</li>
+     * <li>{@link #setStream(java.io.InputStream)}</li>
+     * <li>{@link #setParameters(java.util.List)}</li>
+     * <li>{@link #setParameters(org.apache.http.NameValuePair...)}</li>
+     * <li>{@link #setFile(java.io.File)}</li>
+     * </ul>
      */
     public EntityBuilder setSerializable(final Serializable serializable) {
         clearContent();
@@ -227,13 +242,15 @@ public class EntityBuilder {
     }
 
     /**
-     * Sets entity content as a {@link File}. This method is mutually exclusive with
-     * {@link #setText(String)},
-     * {@link #setBinary(byte[])},
-     * {@link #setStream(java.io.InputStream)} ,
-     * {@link #setParameters(java.util.List)},
-     * {@link #setParameters(org.apache.http.NameValuePair...)}
-     * {@link #setSerializable(java.io.Serializable)} methods.
+     * Sets entity content as a {@link File}. This method is mutually exclusive with:
+     * <ul>
+     * <li>{@link #setText(String)}</li>
+     * <li>{@link #setBinary(byte[])}</li>
+     * <li>{@link #setStream(java.io.InputStream)}</li>
+     * <li>{@link #setParameters(java.util.List)}</li>
+     * <li>{@link #setParameters(org.apache.http.NameValuePair...)}</li>
+     * <li>{@link #setSerializable(java.io.Serializable)}</li>
+     * <ul>
      */
     public EntityBuilder setFile(final File file) {
         clearContent();