more javadoc stuff

Author: cowtowncoder

src/main/java/com/fasterxml/jackson/core/async/NonBlockingInputFeeder.java

@@ -18,12 +18,16 @@ public interface NonBlockingInputFeeder
      * Method called to check whether it is ok to feed more data: parser returns true
      * if it has no more content to parse (and it is ok to feed more); otherwise false
      * (and no data should yet be fed).
+     *
+     * @return {@code True} if more input is needed (and can be fed); {@code false} if
+     *    there is still some input to decode
      */
     public boolean needMoreInput();
 
     /**
      * Method that should be called after last chunk of data to parse has been fed
-     * (with <code>feedInput</code> in sub-class); can be called regardless of what {@link #needMoreInput}
+     * (with {@code feedInput} in sub-class); can be called regardless of what
+     * {@link #needMoreInput}
      * returns. After calling this method, no more data can be fed; and parser assumes
      * no more data will be available.
      */

src/main/java/com/fasterxml/jackson/core/io/CharTypes.java

@@ -206,13 +206,20 @@ public final class CharTypes
      * Value of 0 means "no escaping"; other positive values that value is character
      * to use after backslash; and negative values that generic (backslash - u)
      * escaping is to be used.
+     *
+     * @return 128-entry {@code int[]} that contains escape definitions
      */
     public static int[] get7BitOutputEscapes() { return sOutputEscapes128; }
 
     /**
      * Alternative to {@link #get7BitOutputEscapes()} when a non-standard quote character
      * is used.
      *
+     * @param quoteChar Character used for quoting textual values and property names;
+     *    usually double-quote but sometimes changed to single-quote (apostrophe)
+     *
+     * @return 128-entry {@code int[]} that contains escape definitions
+     *
      * @since 2.10
      */
     public static int[] get7BitOutputEscapes(int quoteChar) {

src/main/java/com/fasterxml/jackson/core/util/InternCache.java

@@ -1,6 +1,5 @@
 package com.fasterxml.jackson.core.util;
 
-import java.util.LinkedHashMap;
 import java.util.concurrent.ConcurrentHashMap;
 
 /**
@@ -9,7 +8,7 @@
  * performance optimization, to avoid calling native intern() method
  * in cases where same String is being interned multiple times.
  *<p>
- * Note: that this class extends {@link LinkedHashMap} is an implementation
+ * Note: that this class extends {@link java.util.LinkedHashMap} is an implementation
  * detail -- no code should ever directly call Map methods.
  */
 public final class InternCache

src/main/java/com/fasterxml/jackson/core/util/JsonParserSequence.java

@@ -60,9 +60,7 @@ protected JsonParserSequence(JsonParser[] parsers) {
         this(false, parsers);
     }
 
-    /**
-     * @since 2.8
-     */
+    // @since 2.8
     protected JsonParserSequence(boolean checkForExistingToken, JsonParser[] parsers)
     {
         super(parsers[0]);

src/main/java/com/fasterxml/jackson/core/util/MinimalPrettyPrinter.java

@@ -54,6 +54,8 @@ public void setRootValueSeparator(String sep) {
     }
 
     /**
+     * @param separators Separator definitions
+     *
      * @since 2.9
      */
     public MinimalPrettyPrinter setSeparators(Separators separators) {

src/main/java/com/fasterxml/jackson/core/util/TextBuffer.java

@@ -7,7 +7,7 @@
 import com.fasterxml.jackson.core.io.NumberInput;
 
 /**
- * TextBuffer is a class similar to {@link StringBuffer}, with
+ * TextBuffer is a class similar to {@link java.lang.StringBuffer}, with
  * following differences:
  *<ul>
  *  <li>TextBuffer uses segments character arrays, to avoid having