fixing obvious javadoc mistakes in core (the kind that cause the javadoc command to generate warning messages)

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

src/java/org/apache/lucene/search/Weight.java

@@ -41,7 +41,7 @@ import org.apache.lucene.index.IndexReader;
  * query.
  * <li>The query normalization factor is passed to {@link #normalize(float)}. At
  * this point the weighting is complete.
- * <li>A <code>Scorer</code> is constructed by {@link #scorer(IndexReader)}.
+ * <li>A <code>Scorer</code> is constructed by {@link #scorer(IndexReader,boolean,boolean)}.
  * </ol>
  * 
  * @since 2.9
@@ -51,8 +51,8 @@ public abstract class Weight implements Serializable {
   /**
    * An explanation of the score computation for the named document.
    * 
-   * Until 3.0, null may be passed in situations where the {@Searcher} is not
-   * available, so impls must only use {@Searcher} to generate optional 
+   * Until 3.0, null may be passed in situations where the Searcher is not
+   * available, so impls must only use Searcher to generate optional 
    * explain info.
    * 
    * @param searcher over the index or null

src/java/org/apache/lucene/search/payloads/BoostingNearQuery.java

@@ -121,7 +121,7 @@ public class BoostingNearQuery extends SpanNearQuery implements PayloadQuery {
      * @param start The start position of the span being scored
      * @param end The end position of the span being scored
      *
-     * @see {@link org.apache.lucene.search.spans.Spans}
+     * @see Spans
      */
     protected void processPayloads(Collection payLoads, int start, int end) {
       for (Iterator iterator = payLoads.iterator(); iterator.hasNext();) {

src/java/org/apache/lucene/search/spans/NearSpansUnordered.java

@@ -220,7 +220,7 @@ public class NearSpansUnordered extends Spans {
   // TODO: Remove warning after API has been finalized
   /**
    * WARNING: The List is not necessarily in order of the the positions
-   * @return
+   * @return Collection of <code>byte[]</code> payloads
    * @throws IOException
    */
   public Collection/*<byte[]>*/ getPayload() throws IOException {

src/java/org/apache/lucene/util/ReaderUtil.java

@@ -45,9 +45,9 @@ public class ReaderUtil {
   /**
    * Returns sub IndexReader that contains the given document id.
    *    
-   * @param doc
-   * @param reader
-   * @return
+   * @param doc id of document
+   * @param reader parent reader
+   * @return sub reader of parent which contains the specified doc id
    */
   public static IndexReader subReader(int doc, IndexReader reader) {
     List subReadersList = new ArrayList();
@@ -66,9 +66,9 @@ public class ReaderUtil {
   /**
    * Returns sub-reader subIndex from reader.
    * 
-   * @param reader
-   * @param subIndex
-   * @return
+   * @param reader parent reader
+   * @param subIndex index of desired sub reader
+   * @return the subreader at subINdex
    */
   public static IndexReader subReader(IndexReader reader, int subIndex) {
     List subReadersList = new ArrayList();