javadoc fixes for Java 13

.gitignore

@@ -10,4 +10,5 @@
 /.gradle
 build
 out
-*~
+*~
+*.iml

netty-http-rx/src/main/java/io/reactivex/netty/channel/ChannelOperations.java

@@ -64,8 +64,6 @@ public interface ChannelOperations<W> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush.</h2>
-     *
      * All writes will be flushed on completion of the passed {@code Observable}
      *
      * @param msgs Stream of messages to write.
@@ -108,8 +106,6 @@ public interface ChannelOperations<W> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush.</h2>
-     *
      * All writes will be flushed on completion of the passed {@code Observable}
      *
      * @param msgs Stream of messages to write.
@@ -152,8 +148,6 @@ public interface ChannelOperations<W> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush.</h2>
-     *
      * All writes will be flushed on completion of the passed {@code Observable}
      *
      * @param msgs Stream of messages to write.
@@ -196,8 +190,6 @@ public interface ChannelOperations<W> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush.</h2>
-     *
      * All writes will be flushed on completion of the passed {@code Observable}
      *
      * @param msgs Stream of messages to write.

netty-http-rx/src/main/java/io/reactivex/netty/channel/Connection.java

@@ -289,8 +289,6 @@ public abstract class Connection<R, W> implements ChannelOperations<W> {
     /**
      * Returns the underlying netty {@link Channel} for this connection.
      *
-     * <h2>Why unsafe?</h2>
-     *
      * It is advisable to use this connection abstraction for all interactions with the channel, however, advanced users
      * may find directly using the netty channel useful in some cases.
      *

netty-http-rx/src/main/java/io/reactivex/netty/protocol/http/server/HttpServerResponse.java

@@ -300,7 +300,6 @@ public abstract class HttpServerResponse<C> extends ResponseContentWriter<C> {
     /**
      * This is a performance optimization to <em>not</em> flush the channel on every response send.
      *
-     * <h2>When NOT to use</h2>
      * This can be used
      * only when the processing for a server is not asynchronous, in which case, one would have to flush the responses
      * written explicitly (done on completion of the {@link Observable} written). Something like this:
@@ -312,8 +311,6 @@ public abstract class HttpServerResponse<C> extends ResponseContentWriter<C> {
                                    )
      </PRE>
      *
-     * <h2>When to use</h2>
-     *
      * This can be used when the response is written synchronously from a {@link RequestHandler}, something like:
      *
      <PRE>

netty-http-rx/src/main/java/io/reactivex/netty/protocol/http/server/ResponseContentWriter.java

@@ -38,8 +38,6 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush</h2>
-     *
      * The writes are flushed when the passed stream completes.
      *
      * @param msgs Stream of messages to write.
@@ -57,14 +55,10 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
      * {@code trailerMutator} will be invoked for every item emitted from the content source, giving a chance to modify
      * the trailing headers instance.
      *
-     * <h2>Multiple invocations</h2>
-     *
      * This method can <em>not</em> be invoked multiple times for the same response as on completion of the passed
      * source, it writes the trailing headers and trailing headers can only be written once for an HTTP response.
      * So, any subsequent invocation of this method will always emit an error when subscribed.
      *
-     * <h2>Flush</h2>
-     *
      * The writes are flushed when the passed stream completes.
      *
      * @param contentSource Content source for the response.
@@ -85,8 +79,6 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
      * {@code trailerMutator} will be invoked for every item emitted from the content source, giving a chance to modify
      * the trailing headers instance.
      *
-     * <h2>Multiple invocations</h2>
-     *
      * This method can <em>not</em> be invoked multiple times for the same response as on completion of the passed
      * source, it writes the trailing headers and trailing headers can only be written once for an HTTP response.
      * So, any subsequent invocation of this method will always emit an error when subscribed.
@@ -137,8 +129,6 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush</h2>
-     *
      * The writes are flushed when the passed stream completes.
      *
      * @param msgs Stream of messages to write.
@@ -156,14 +146,10 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
      * {@code trailerMutator} will be invoked for every item emitted from the content source, giving a chance to modify
      * the trailing headers instance.
      *
-     * <h2>Multiple invocations</h2>
-     *
      * This method can <em>not</em> be invoked multiple times for the same response as on completion of the passed
      * source, it writes the trailing headers and trailing headers can only be written once for an HTTP response.
      * So, any subsequent invocation of this method will always emit an error when subscribed.
      *
-     * <h2>Flush</h2>
-     *
      * The writes are flushed when the passed stream completes.
      *
      * @param contentSource Content source for the response.
@@ -184,8 +170,6 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
      * {@code trailerMutator} will be invoked for every item emitted from the content source, giving a chance to modify
      * the trailing headers instance.
      *
-     * <h2>Multiple invocations</h2>
-     *
      * This method can <em>not</em> be invoked multiple times for the same response as on completion of the passed
      * source, it writes the trailing headers and trailing headers can only be written once for an HTTP response.
      * So, any subsequent invocation of this method will always emit an error when subscribed.
@@ -236,8 +220,6 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
     /**
      * On subscription of the returned {@link Observable}, writes the passed message stream on the underneath channel.
      *
-     * <h2>Flush</h2>
-     *
      * The writes are flushed when the passed stream completes.
      *
      * @param msgs Stream of messages to write.
@@ -255,14 +237,10 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
      * {@code trailerMutator} will be invoked for every item emitted from the content source, giving a chance to modify
      * the trailing headers instance.
      *
-     * <h2>Multiple invocations</h2>
-     *
      * This method can <em>not</em> be invoked multiple times for the same response as on completion of the passed
      * source, it writes the trailing headers and trailing headers can only be written once for an HTTP response.
      * So, any subsequent invocation of this method will always emit an error when subscribed.
      *
-     * <h2>Flush</h2>
-     *
      * The writes are flushed when the passed stream completes.
      *
      * @param contentSource Content source for the response.
@@ -283,8 +261,6 @@ public abstract class ResponseContentWriter<C> extends Observable<Void> {
      * {@code trailerMutator} will be invoked for every item emitted from the content source, giving a chance to modify
      * the trailing headers instance.
      *
-     * <h2>Multiple invocations</h2>
-     *
      * This method can <em>not</em> be invoked multiple times for the same response as on completion of the passed
      * source, it writes the trailing headers and trailing headers can only be written once for an HTTP response.
      * So, any subsequent invocation of this method will always emit an error when subscribed.