Javadoc suggestions

extensions/barrage/src/main/java/io/deephaven/extensions/barrage/BarrageStreamGenerator.java

@@ -22,6 +22,10 @@
  */
 public interface BarrageStreamGenerator extends SafeCloseable {
 
+    /**
+     * Represents a single update, which might be sent as multiple distinct payloads as necessary based in the
+     * implementation.
+     */
     interface MessageView {
         void forEachStream(Consumer<DefensiveDrainable> visitor) throws IOException;
     }

extensions/barrage/src/main/java/io/deephaven/extensions/barrage/BarrageStreamGeneratorImpl.java

@@ -647,8 +647,9 @@ int visit(final RecordBatchMessageView view, final long startRange, final int ta
     }
 
     /**
-     * Returns an InputStream of the message filtered to the viewport. This function accepts `targetBatchSize` but may
-     * actually write fewer rows than the target (when crossing an internal chunk boundary, e.g.)
+     * Returns an InputStream of a single FlightData message filtered to the viewport (if provided). This function
+     * accepts {@code targetBatchSize}, but may actually write fewer rows than the target (e.g. when crossing an
+     * internal chunk boundary).
      *
      * @param view the view of the overall chunk to generate a RecordBatch for
      * @param offset the start of the batch in position space w.r.t. the view (inclusive)