SOLR-962: Note about null handling in ModifiableSolrParams.add javadoc

git-svn-id: https://svn.apache.org/repos/asf/lucene/solr/trunk@737467 13f79535-47bb-0310-9956-ffa450edef68

CHANGES.txt

@@ -265,7 +265,8 @@ Documentation
 ----------------------
  1. SOLR-789: The javadoc of RandomSortField is not readable (Nicolas Lalevée via koji)
 
-
+ 2. SOLR-962: Note about null handling in ModifiableSolrParams.add javadoc
+    (Kay Kay via hossman)
 
 ================== Release 1.3.0 20080915 ==================
 

src/common/org/apache/solr/common/params/ModifiableSolrParams.java

@@ -84,6 +84,11 @@ public class ModifiableSolrParams extends SolrParams
 
   /**
    * Add the given values to any existing name
+   * @param name Key
+   * @param val Array of value(s) added to the name. NOTE: If val is null 
+   *     or a member of val is null, then a corresponding null reference 
+   *     will be included when a get method is called on the key later.
+   *  @return this
    */
   public ModifiableSolrParams add( String name, String ... val ) {
     String[] old = vals.put(name, val);