Minor javadoc improvements

Author: cowtowncoder

avro/src/main/java/com/fasterxml/jackson/dataformat/avro/AvroGenerator.java

@@ -21,7 +21,7 @@ public class AvroGenerator extends GeneratorBase
     public enum Feature
         implements FormatFeature // since 2.7
     {
-        // !!! TODO: remove from 2.8
+        // !!! TODO: remove from 2.9
         /**
          * Feature that can be enabled to quietly ignore serialization of properties
          * that can not be mapped to output schema: if enabled, trying to output
@@ -42,6 +42,8 @@ public enum Feature
          * Feature that can be disabled to prevent Avro from buffering any more
          * data then absolutely necessary.
          * This affects buffering by underlying codec.
+         * Note that disabling buffer is likely to reduce performance if the underlying
+         * input/output is unbuffered.
          *<p>
          * Enabled by default to preserve the existing behavior.
          *
@@ -357,13 +359,13 @@ public void close() throws IOException
     /* Public API: structural output
     /**********************************************************
      */
-    
+
     @Override
     public final void writeStartArray() throws IOException {
         _avroContext = _avroContext.createChildArrayContext();
         _complete = false;
     }
-    
+
     @Override
     public final void writeEndArray() throws IOException
     {

avro/src/main/java/com/fasterxml/jackson/dataformat/avro/AvroMapper.java

@@ -52,6 +52,11 @@ public AvroFactory getFactory() {
     }
 
     /**
+     * Factory method for constructing {@link AvroSchema} by introspecting given
+     * POJO type and building schema that contains specified properties.
+     *<p>
+     * Resulting schema object does not use separate reader/writer schemas.
+     *
      * @since 2.5
      */
     public AvroSchema schemaFor(Class<?> type) throws JsonMappingException
@@ -62,6 +67,11 @@ public AvroSchema schemaFor(Class<?> type) throws JsonMappingException
     }
 
     /**
+     * Factory method for constructing {@link AvroSchema} by introspecting given
+     * POJO type and building schema that contains specified properties.
+     *<p>
+     * Resulting schema object does not use separate reader/writer schemas.
+     *
      * @since 2.5
      */
     public AvroSchema schemaFor(JavaType type) throws JsonMappingException
@@ -74,6 +84,8 @@ public AvroSchema schemaFor(JavaType type) throws JsonMappingException
     /**
      * Method for reading an Avro Schema from given {@link InputStream},
      * and once done (successfully or not), closing the stream.
+     *<p>
+     * Resulting schema object does not use separate reader/writer schemas.
      *
      * @since 2.6
      */
@@ -90,6 +102,8 @@ public AvroSchema schemaFrom(InputStream in) throws IOException
     /**
      * Convenience method for reading {@link AvroSchema} from given
      * encoded JSON representation.
+     *<p>
+     * Resulting schema object does not use separate reader/writer schemas.
      *
      * @since 2.6
      */
@@ -102,6 +116,8 @@ public AvroSchema schemaFrom(String schemaAsString) throws IOException
     /**
      * Convenience method for reading {@link AvroSchema} from given
      * encoded JSON representation.
+     *<p>
+     * Resulting schema object does not use separate reader/writer schemas.
      *
      * @since 2.6
      */

avro/src/main/java/com/fasterxml/jackson/dataformat/avro/AvroSchema.java

@@ -84,7 +84,7 @@ public static BinaryEncoder encoder(OutputStream out, boolean buffering)
         BinaryEncoder prev = (ref == null) ? null : ref.get();
         /* Factory will check if the encoder has a matching type for reuse.
          * If not, it will drop the instance being reused and will return
-         * a new, proper one.
+         * a new, properly initialized instance
          */
         BinaryEncoder next =
             buffering