Fix Fluent(CaseInsensitiveStrings)Map.add javadoc, close AsyncHttpClient#581

Author: Stephane Landelle

api/src/main/java/org/asynchttpclient/FluentCaseInsensitiveStringsMap.java

@@ -64,8 +64,7 @@ public FluentCaseInsensitiveStringsMap(Map<String, Collection<String>> src) {
      * Adds the specified values and returns this object.
      *
      * @param key    The key
-     * @param values The value(s); if null then this method has no effect. Use the empty string to
-     *               generate an empty value
+     * @param values The value(s); if the array is null then this method has no effect. Individual null values are turned into empty strings
      * @return This object
      */
     public FluentCaseInsensitiveStringsMap add(String key, String... values) {

api/src/main/java/org/asynchttpclient/FluentStringsMap.java

@@ -58,8 +58,7 @@ public FluentStringsMap(Map<String, Collection<String>> src) {
      * Adds the specified values and returns this object.
      *
      * @param key    The key
-     * @param values The value(s); if null then this method has no effect. Use the empty string to
-     *               generate an empty value
+     * @param values The value(s); if the array is null then this method has no effect
      * @return This object
      */
     public FluentStringsMap add(String key, String... values) {
@@ -73,8 +72,7 @@ public FluentStringsMap add(String key, String... values) {
      * Adds the specified values and returns this object.
      *
      * @param key    The key
-     * @param values The value(s); if null then this method has no effect. Use an empty collection
-     *               to generate an empty value
+     * @param values The value(s); if the array is null then this method has no effect
      * @return This object
      */
     public FluentStringsMap add(String key, Collection<String> values) {