adding javadoc for getLimitingFacets()

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

src/solrj/org/apache/solr/client/solrj/response/QueryResponse.java

@@ -271,6 +271,9 @@ public class QueryResponse extends SolrResponseBase
     return _spellResponse;
   }
 
+  /**
+   * See also: {@link #getLimitingFacets()}
+   */
   public List<FacetField> getFacetFields() {
     return _facetFields;
   }
@@ -301,6 +304,13 @@ public class QueryResponse extends SolrResponseBase
     return null;
   }
   
+  /**
+   * @return a list of FacetFields where the count is less then
+   * then #getResults() {@link SolrDocumentList#getNumFound()}
+   * 
+   * If you want all results exactly as returned by solr, use:
+   * {@link #getFacetFields()}
+   */
   public List<FacetField> getLimitingFacets() {
     return _limitingFacets;
   }