Merge branch '2.18'

src/main/java/tools/jackson/core/JsonParser.java

@@ -18,7 +18,7 @@
 import tools.jackson.core.sym.PropertyNameMatcher;
 import tools.jackson.core.type.ResolvedType;
 import tools.jackson.core.type.TypeReference;
-import tools.jackson.core.util.JacksonFeatureSet;
+import tools.jackson.core.util.*;
 
 /**
  * Base class that defines public API for reading JSON content.
@@ -869,6 +869,12 @@ public Boolean nextBooleanValue() throws JacksonException {
      * but should typically be more efficient as longer content does need to
      * be combined into a single <code>String</code> to return, and write
      * can occur directly from intermediate buffers Jackson uses.
+     *<p>
+     * NOTE: textual content <b>will</b> still be buffered (usually
+     * using {@link TextBuffer}) and <b>will</b> be accessible with
+     * other {@code getText()} calls (that is, it will not be consumed).
+     * So this accessor only avoids construction of {@link java.lang.String}
+     * compared to plain {@link #getText()} method.
      *
      * @param writer Writer to write textual content to
      *