diff --git a/docs/Backpressure.md b/docs/Backpressure.md index eadcfff263..8529ec0995 100644 --- a/docs/Backpressure.md +++ b/docs/Backpressure.md @@ -20,7 +20,7 @@ Cold Observables are ideal for the reactive pull model of backpressure described Your first line of defense against the problems of over-producing Observables is to use some of the ordinary set of Observable operators to reduce the number of emitted items to a more manageable number. The examples in this section will show how you might use such operators to handle a bursty Observable like the one illustrated in the following marble diagram: -​ +​ By fine-tuning the parameters to these operators you can ensure that a slow-consuming observer is not overwhelmed by a fast-producing Observable. @@ -33,7 +33,7 @@ The following diagrams show how you could use each of these operators on the bur ### sample (or throttleLast) The `sample` operator periodically "dips" into the sequence and emits only the most recently emitted item during each dip: -​ +​ ```java Observable burstySampled = bursty.sample(500, TimeUnit.MILLISECONDS); ``` @@ -41,7 +41,7 @@ Observable burstySampled = bursty.sample(500, TimeUnit.MILLISECONDS); ### throttleFirst The `throttleFirst` operator is similar, but emits not the most recently emitted item, but the first item that was emitted after the previous "dip": -​ +​ ```java Observable burstyThrottled = bursty.throttleFirst(500, TimeUnit.MILLISECONDS); ``` @@ -49,7 +49,7 @@ Observable burstyThrottled = bursty.throttleFirst(500, TimeUnit.MILLISE ### debounce (or throttleWithTimeout) The `debounce` operator emits only those items from the source Observable that are not followed by another item within a specified duration: -​ +​ ```java Observable burstyDebounced = bursty.debounce(10, TimeUnit.MILLISECONDS); ``` @@ -64,14 +64,14 @@ The following diagrams show how you could use each of these operators on the bur You could, for example, close and emit a buffer of items from the bursty Observable periodically, at a regular interval of time: -​ +​ ```java Observable> burstyBuffered = bursty.buffer(500, TimeUnit.MILLISECONDS); ``` Or you could get fancy, and collect items in buffers during the bursty periods and emit them at the end of each burst, by using the `debounce` operator to emit a buffer closing indicator to the `buffer` operator: -​ +​ ```java // we have to multicast the original bursty Observable so we can use it // both as our source and as the source for our buffer closing selector: @@ -86,14 +86,14 @@ Observable> burstyBuffered = burstyMulticast.buffer(burstyDebounce `window` is similar to `buffer`. One variant of `window` allows you to periodically emit Observable windows of items at a regular interval of time: -​ +​ ```java Observable> burstyWindowed = bursty.window(500, TimeUnit.MILLISECONDS); ```` You could also choose to emit a new window each time you have collected a particular number of items from the source Observable: -​ +​ ```java Observable> burstyWindowed = bursty.window(5); ``` @@ -158,11 +158,11 @@ For this to work, though, Observables _A_ and _B_ must respond correctly to the
onBackpressureBuffer
-
maintains a buffer of all emissions from the source Observable and emits them to downstream Subscribers according to the requests they generate

an experimental version of this operator (not available in RxJava 1.0) allows you to set the capacity of the buffer; applying this operator will cause the resulting Observable to terminate with an error if this buffer is overrun​
+
maintains a buffer of all emissions from the source Observable and emits them to downstream Subscribers according to the requests they generate

an experimental version of this operator (not available in RxJava 1.0) allows you to set the capacity of the buffer; applying this operator will cause the resulting Observable to terminate with an error if this buffer is overrun​
onBackpressureDrop
-
drops emissions from the source Observable unless there is a pending request from a downstream Subscriber, in which case it will emit enough items to fulfill the request
​
+
drops emissions from the source Observable unless there is a pending request from a downstream Subscriber, in which case it will emit enough items to fulfill the request
​
onBackpressureBlock (experimental, not in RxJava 1.0)
-
blocks the thread on which the source Observable is operating until such time as a Subscriber issues a request for items, and then unblocks the thread only so long as there are pending requests
+
blocks the thread on which the source Observable is operating until such time as a Subscriber issues a request for items, and then unblocks the thread only so long as there are pending requests
If you do not apply any of these operators to an Observable that does not support backpressure, _and_ if either you as the Subscriber or some operator between you and the Observable attempts to apply reactive pull backpressure, you will encounter a `MissingBackpressureException` which you will be notified of via your `onError()` callback. diff --git a/docs/Blocking-Observable-Operators.md b/docs/Blocking-Observable-Operators.md index 64d6e1b40a..fe2a640f49 100644 --- a/docs/Blocking-Observable-Operators.md +++ b/docs/Blocking-Observable-Operators.md @@ -18,7 +18,7 @@ To transform an `Observable` into a `BlockingObservable`, use the [`Observable.t > This documentation accompanies its explanations with a modified form of "marble diagrams." Here is how these marble diagrams represent Blocking Observables: - + #### see also: * javadoc: `BlockingObservable` diff --git a/docs/Connectable-Observable-Operators.md b/docs/Connectable-Observable-Operators.md index a048547529..582f0fac12 100644 --- a/docs/Connectable-Observable-Operators.md +++ b/docs/Connectable-Observable-Operators.md @@ -7,7 +7,7 @@ This section explains the [`ConnectableObservable`](http://reactivex.io/RxJava/j A Connectable Observable resembles an ordinary Observable, except that it does not begin emitting items when it is subscribed to, but only when its `connect()` method is called. In this way you can wait for all intended Subscribers to subscribe to the Observable before the Observable begins emitting items. - + The following example code shows two Subscribers subscribing to the same Observable. In the first case, they subscribe to an ordinary Observable; in the second case, they subscribe to a Connectable Observable that only connects after both Subscribers subscribe. Note the difference in the output: diff --git a/docs/How-To-Use-RxJava.md b/docs/How-To-Use-RxJava.md index ad309496b9..2d091bdce4 100644 --- a/docs/How-To-Use-RxJava.md +++ b/docs/How-To-Use-RxJava.md @@ -285,7 +285,7 @@ onNext => value_14_xform Here is a marble diagram that illustrates this transformation: - + This next example, in Clojure, consumes three asynchronous Observables, including a dependency from one to another, and emits a single response item by combining the items emitted by each of the three Observables with the [`zip`](http://reactivex.io/documentation/operators/zip.html) operator and then transforming the result with [`map`](http://reactivex.io/documentation/operators/map.html): @@ -333,7 +333,7 @@ The response looks like this: And here is a marble diagram that illustrates how that code produces that response: - + The following example, in Groovy, comes from [Ben Christensen’s QCon presentation on the evolution of the Netflix API](https://speakerdeck.com/benjchristensen/evolution-of-the-netflix-api-qcon-sf-2013). It combines two Observables with the [`merge`](http://reactivex.io/documentation/operators/merge.html) operator, then uses the [`reduce`](http://reactivex.io/documentation/operators/reduce.html) operator to construct a single item out of the resulting sequence, then transforms that item with [`map`](http://reactivex.io/documentation/operators/map.html) before emitting it: @@ -350,7 +350,7 @@ public Observable getVideoSummary(APIVideo video) { And here is a marble diagram that illustrates how that code uses the [`reduce`](http://reactivex.io/documentation/operators/reduce.html) operator to bring the results from multiple Observables together in one structure: - + ## Error Handling diff --git a/docs/Phantom-Operators.md b/docs/Phantom-Operators.md index 60da4a1a40..b01ac28ff2 100644 --- a/docs/Phantom-Operators.md +++ b/docs/Phantom-Operators.md @@ -19,7 +19,7 @@ These operators have been proposed but are not part of the 1.0 release of RxJava ## chunkify( ) #### returns an iterable that periodically returns a list of items emitted by the source Observable since the last list - + The `chunkify( )` operator represents a blocking observable as an Iterable, that, each time you iterate over it, returns a list of items emitted by the source Observable since the previous iteration. These lists may be empty if there have been no such items emitted. @@ -27,7 +27,7 @@ The `chunkify( )` operator represents a blocking observable as an Iterable, th ## fromFuture( ) #### convert a Future into an Observable, but do not attempt to get the Future's value until a Subscriber subscribes - + The `fromFuture( )` method also converts a Future into an Observable, but it obtains this Future indirectly, by means of a function you provide. It creates the Observable immediately, but waits to call the function and to obtain the Future until a Subscriber subscribes to it. @@ -35,7 +35,7 @@ The `fromFuture( )` method also converts a Future into an Observable, but it o ## forEachFuture( ) #### create a futureTask that will invoke a specified function on each item emitted by an Observable - + The `forEachFuture( )` returns a `FutureTask` for each item emitted by the source Observable (or each item and each notification) that, when executed, will apply a function you specify to each such item (or item and notification). @@ -43,7 +43,7 @@ The `forEachFuture( )` returns a `FutureTask` for each item emitted by the sou ## forIterable( ) #### apply a function to the elements of an Iterable to create Observables which are then concatenated - + `forIterable( )` is similar to `from(Iterable )` but instead of the resulting Observable emitting the elements of the Iterable as its own emitted items, it applies a specified function to each of these elements to generate one Observable per element, and then concatenates the emissions of these Observables to be its own sequence of emitted items. @@ -58,7 +58,7 @@ If the a subscriber to the Observable that results when a Future is converted to ## generate( ) and generateAbsoluteTime( ) #### create an Observable that emits a sequence of items as generated by a function of your choosing - + The basic form of `generate( )` takes four parameters. These are `initialState` and three functions: `iterate( )`, `condition( )`, and `resultSelector( )`. `generate( )` uses these four parameters to generate an Observable sequence, which is its return value. It does so in the following way. @@ -66,7 +66,7 @@ The basic form of `generate( )` takes four parameters. These are `initialState There are also versions of `generate( )` that allow you to do the work of generating the sequence on a particular `Scheduler` and that allow you to set the time interval between emissions by applying a function to the current state. The `generateAbsoluteTime( )` allows you to control the time at which an item is emitted by applying a function to the state to get an absolute system clock time (rather than an interval from the previous emission). - + #### see also: * Introduction to Rx: Generate @@ -79,7 +79,7 @@ There are also versions of `generate( )` that allow you to do the work of gene This version of `groupBy` adds another parameter: an Observable that emits duration markers. When a duration marker is emitted by this Observable, any grouped Observables that have been opened are closed, and `groupByUntil( )` will create new grouped Observables for any subsequent emissions by the source Observable. -​ +​ Another variety of `groupByUntil( )` limits the number of groups that can be active at any particular time. If an item is emitted by the source Observable that would cause the number of groups to exceed this maximum, before the new group is emitted, one of the existing groups is closed (that is, the Observable it represents terminates by calling its Subscribers' `onCompleted` methods and then expires). @@ -101,7 +101,7 @@ To represent an Observable as a Connectable Observable, use the `multicast( )` ## onErrorFlatMap( ) #### instructs an Observable to emit a sequence of items whenever it encounters an error -​ +​ The `onErrorFlatMap( )` method is similar to `onErrorResumeNext( )` except that it does not assume the source Observable will correctly terminate when it issues an error. Because of this, after emitting its backup sequence of items, `onErrorFlatMap( )` relinquishes control of the emitted sequence back to the source Observable. If that Observable again issues an error, `onErrorFlatMap( )` will again emit its backup sequence. @@ -111,13 +111,13 @@ Because `onErrorFlatMap( )` is designed to work with pathological source Obser Note that you should apply `onErrorFlatMap( )` directly to the pathological source Observable, and not to that Observable after it has been modified by additional operators, as such operators may effectively renormalize the source Observable by unsubscribing from it immediately after it issues an error. Below, for example, is an illustration showing how `onErrorFlatMap( )` will respond to two error-generating Observables that have been merged by the `merge( )` operator. Note that it will *not* react to both errors generated by both Observables, but only to the single error passed along by `merge( )`: -​ +​ *** ## parallel( ) #### split the work done on the emissions from an Observable into multiple Observables each operating on its own parallel thread -​ +​ The `parallel( )` method splits an Observable into as many Observables as there are available processors, and does work in parallel on each of these Observables. `parallel( )` then merges the results of these parallel computations back into a single, well-behaved Observable sequence. @@ -136,7 +136,7 @@ Kick off your work for each item inside [`flatMap`](Transforming-Observables#fla ## parallelMerge( ) #### combine multiple Observables into a smaller number of Observables, to facilitate parallelism -​ +​ Use the `parallelMerge( )` method to take an Observable that emits a large number of Observables and to reduce it to an Observable that emits a particular, smaller number of Observables that emit the same set of items as the original larger set of Observables: for instance a number of Observables that matches the number of parallel processes that you want to use when processing the emissions from the complete set of Observables. @@ -144,7 +144,7 @@ Use the `parallelMerge( )` method to take an Observable that emits a large num ## pivot( ) #### combine multiple sets of grouped observables so that they are arranged primarily by group rather than by set -​ +​ If you combine multiple sets of grouped observables, such as those created by [`groupBy( )` and `groupByUntil( )`](Transforming-Observables#wiki-groupby-and-groupbyuntil), then even if those grouped observables have been grouped by a similar differentiation function, the resulting grouping will be primarily based on which set the observable came from, not on which group the observable belonged to. @@ -152,13 +152,13 @@ An example may make this clearer. Imagine you use `groupBy( )` to group the em The result will be a grouped observable that emits two groups: the grouped observable resulting from transforming Observable1, and the grouped observable resulting from transforming Observable2. Each of those grouped observables emit observables that in turn emit the odds and evens from the source observables. You can use `pivot( )` to change this around: by applying `pivot( )` to this grouped observable it will transform into one that emits two different groups: the odds group and the evens group, with each of these groups emitting a separate observable corresponding to which source observable its set of integers came from. Here is an illustration: -​ +​ *** ## publishLast( ) #### represent an Observable as a Connectable Observable that emits only the last item emitted by the source Observable - + #### see also: * RxJS: `publishLast` diff --git a/src/main/java/io/reactivex/rxjava3/core/Completable.java b/src/main/java/io/reactivex/rxjava3/core/Completable.java index 6662dceb0c..f261d1a782 100644 --- a/src/main/java/io/reactivex/rxjava3/core/Completable.java +++ b/src/main/java/io/reactivex/rxjava3/core/Completable.java @@ -2172,7 +2172,7 @@ public final Completable lift(@NonNull CompletableOperator onLift) { * Maps the signal types of this {@code Completable} into a {@link Notification} of the same kind * and emits it as a single success value to downstream. *

- * + * *

*
Scheduler:
*
{@code materialize} does not operate by default on a particular {@link Scheduler}.
diff --git a/src/main/java/io/reactivex/rxjava3/core/Flowable.java b/src/main/java/io/reactivex/rxjava3/core/Flowable.java index 33c89e1343..2843a2909a 100644 --- a/src/main/java/io/reactivex/rxjava3/core/Flowable.java +++ b/src/main/java/io/reactivex/rxjava3/core/Flowable.java @@ -53,7 +53,7 @@ *

* The documentation for this class makes use of marble diagrams. The following legend explains these diagrams: *

- * + * *

* The {@code Flowable} follows the protocol * 


@@ -163,7 +163,7 @@ public abstract class Flowable<@NonNull T> implements Publisher {
      * Mirrors the one {@link Publisher} in an {@link Iterable} of several {@code Publisher}s that first either emits an item or sends
      * a termination notification.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator itself doesn't interfere with backpressure which is determined by the winning
@@ -193,7 +193,7 @@ public static  Flowable amb(@NonNull Iterable<@NonNull ? extends Publisher
      * Mirrors the one {@link Publisher} in an array of several {@code Publisher}s that first either emits an item or sends
      * a termination notification.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator itself doesn't interfere with backpressure which is determined by the winning
@@ -646,7 +646,7 @@ public static  Flowable combineLatestDelayError(@NonNull Iterable<@NonN
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -692,7 +692,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -743,7 +743,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -799,7 +799,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -860,7 +860,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -925,7 +925,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -996,7 +996,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -1071,7 +1071,7 @@ public static  Flowable combineLatest(
      * resulting sequence terminates immediately (normally or with all the errors accumulated until that point).
      * If that input source is also synchronous, other sources after it will not be subscribed to.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Publisher} honors backpressure from downstream. The source {@code Publisher}s
@@ -1147,7 +1147,7 @@ public static  Flowable combineLatest(
      * Concatenates elements of each {@link Publisher} provided via an {@link Iterable} sequence into a single sequence
      * of elements without interleaving them.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The {@code Publisher}
@@ -1177,7 +1177,7 @@ public static  Flowable concat(@NonNull Iterable<@NonNull ? extends Publis
      * Returns a {@code Flowable} that emits the items emitted by each of the {@link Publisher}s emitted by the source
      * {@code Publisher}, one after the other, without interleaving them.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. Both the outer and inner {@code Publisher}
@@ -1207,7 +1207,7 @@ public static  Flowable concat(@NonNull Publisher<@NonNull ? extends Publi
      * Returns a {@code Flowable} that emits the items emitted by each of the {@link Publisher}s emitted by the source
      * {@code Publisher}, one after the other, without interleaving them.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. Both the outer and inner {@code Publisher}
@@ -1241,7 +1241,7 @@ public static  Flowable concat(@NonNull Publisher<@NonNull ? extends Publi
      * Returns a {@code Flowable} that emits the items emitted by two {@link Publisher}s, one after the other, without
      * interleaving them.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The {@code Publisher}
@@ -1275,7 +1275,7 @@ public static  Flowable concat(@NonNull Publisher<@NonNull ? extends T> so
      * Returns a {@code Flowable} that emits the items emitted by three {@link Publisher}s, one after the other, without
      * interleaving them.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The {@code Publisher}
@@ -1314,7 +1314,7 @@ public static  Flowable concat(
      * Returns a {@code Flowable} that emits the items emitted by four {@link Publisher}s, one after the other, without
      * interleaving them.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The {@code Publisher}
@@ -1357,7 +1357,7 @@ public static  Flowable concat(
      * 

      * Note: named this way because of overload conflict with {@code concat(Publisher>}).
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The {@code Publisher}
@@ -1392,7 +1392,7 @@ public static  Flowable concatArray(@NonNull Publisher<@NonNull ? extends
      * Concatenates a variable number of {@link Publisher} sources and delays errors from any of them
      * till all terminate.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The {@code Publisher}
@@ -1997,7 +1997,7 @@ public static  Flowable create(@NonNull FlowableOnSubscribe source, @No
      * that subscribes. That is, for each subscriber, the actual {@code Publisher} that subscriber observes is
      * determined by the factory function.
      * 

-     * 
+     * 
      * 

      * The defer {@code Subscriber} allows you to defer or delay emitting items from a {@code Publisher} until such time as a
      * {@code Subscriber} subscribes to the {@code Publisher}. This allows a {@code Subscriber} to easily obtain updates or a
@@ -2032,7 +2032,7 @@ public static  Flowable defer(@NonNull Supplier
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This source doesn't produce any elements and effectively ignores downstream backpressure.

@@ -2058,7 +2058,7 @@ public static  Flowable empty() {
      * Returns a {@code Flowable} that invokes a {@link Subscriber}'s {@link Subscriber#onError onError} method when the
      * {@code Subscriber} subscribes to it.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This source doesn't produce any elements and effectively ignores downstream backpressure.

@@ -2087,7 +2087,7 @@ public static  Flowable error(@NonNull Supplier suppl
      * Returns a {@code Flowable} that invokes a {@link Subscriber}'s {@link Subscriber#onError onError} method when the
      * {@code Subscriber} subscribes to it.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This source doesn't produce any elements and effectively ignores downstream backpressure.

@@ -2148,7 +2148,7 @@ public static  Flowable fromAction(@NonNull Action action) {
     /**
      * Converts an array into a {@link Publisher} that emits the items in the array.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and iterates the given {@code array}
@@ -2185,7 +2185,7 @@ public static  Flowable fromAction(@NonNull Action action) {
      * Returns a {@code Flowable} that, when a {@link Subscriber} subscribes to it, invokes a function you specify and then
      * emits the value returned from that function.
      * 

-     * 
+     * 
      * 

      * This allows you to defer the execution of the function you specify until a {@code Subscriber} subscribes to the
      * {@link Publisher}. That is to say, it makes the function "lazy."
@@ -2250,7 +2250,7 @@ public static  Flowable fromCompletable(@NonNull CompletableSource complet
     /**
      * Converts a {@link Future} into a {@link Publisher}.
      * 

-     * 
+     * 
      * 

      * The operator calls {@link Future#get()}, which is a blocking method, on the subscription thread.
      * It is recommended applying {@link #subscribeOn(Scheduler)} to move this blocking wait to a
@@ -2292,7 +2292,7 @@ public static  Flowable fromCompletable(@NonNull CompletableSource complet
     /**
      * Converts a {@link Future} into a {@link Publisher}, with a timeout on the {@code Future}.
      * 

-     * 
+     * 
      * 

      * The operator calls {@link Future#get(long, TimeUnit)}, which is a blocking method, on the subscription thread.
      * It is recommended applying {@link #subscribeOn(Scheduler)} to move this blocking wait to a
@@ -2339,7 +2339,7 @@ public static  Flowable fromCompletable(@NonNull CompletableSource complet
     /**
      * Converts an {@link Iterable} sequence into a {@link Publisher} that emits the items in the sequence.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and iterates the given {@code iterable}
@@ -2559,7 +2559,7 @@ public static  Flowable fromSingle(@NonNull SingleSource source) {
      * Returns a {@code Flowable} that, when a {@link Subscriber} subscribes to it, invokes a supplier function you specify and then
      * emits the value returned from that function.
      * 

-     * 
+     * 
      * 

      * This allows you to defer the execution of the function you specify until a {@code Subscriber} subscribes to the
      * {@link Publisher}. That is to say, it makes the function "lazy."
@@ -2775,7 +2775,7 @@ public static  Flowable generate(@NonNull Supplier initialState, @No
      * Returns a {@code Flowable} that emits a {@code 0L} after the {@code initialDelay} and ever-increasing numbers
      * after each {@code period} of time thereafter.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator generates values based on time and ignores downstream backpressure which
@@ -2808,7 +2808,7 @@ public static Flowable interval(long initialDelay, long period, @NonNull T
      * Returns a {@code Flowable} that emits a {@code 0L} after the {@code initialDelay} and ever-increasing numbers
      * after each {@code period} of time thereafter, on a specified {@link Scheduler}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator generates values based on time and ignores downstream backpressure which
@@ -2844,7 +2844,7 @@ public static Flowable interval(long initialDelay, long period, @NonNull T
     /**
      * Returns a {@code Flowable} that emits a sequential number every specified interval of time.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator signals a {@link MissingBackpressureException} if the downstream
@@ -2873,7 +2873,7 @@ public static Flowable interval(long period, @NonNull TimeUnit unit) {
      * Returns a {@code Flowable} that emits a sequential number every specified interval of time, on a
      * specified {@link Scheduler}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator generates values based on time and ignores downstream backpressure which
@@ -2978,7 +2978,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Returns a {@code Flowable} that signals the given (constant reference) item and then completes.
      * 

-     * 
+     * 
      * 

      * Note that the item is taken and re-emitted as is and not computed by any means by {@code just}. Use {@link #fromCallable(Callable)}
      * to generate a single item on demand (when {@link Subscriber}s subscribe to it).
@@ -3018,7 +3018,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts two items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3050,7 +3050,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts three items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3085,7 +3085,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts four items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3124,7 +3124,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts five items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3166,7 +3166,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts six items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3211,7 +3211,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts seven items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3260,7 +3260,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts eight items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3312,7 +3312,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts nine items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3367,7 +3367,7 @@ public static Flowable intervalRange(long start, long count, long initialD
     /**
      * Converts ten items into a {@link Publisher} that emits those items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals each value on-demand (i.e., when requested).

@@ -3427,7 +3427,7 @@ public static Flowable intervalRange(long start, long count, long initialD
      * Flattens an {@link Iterable} of {@link Publisher}s into one {@code Publisher}, without any transformation, while limiting the
      * number of concurrent subscriptions to these {@code Publisher}s.
      * 

-     * 
+     * 
      * 

      * You can combine the items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3479,7 +3479,7 @@ public static  Flowable merge(@NonNull Iterable<@NonNull ? extends Publish
      * Flattens an array of {@link Publisher}s into one {@code Publisher}, without any transformation, while limiting the
      * number of concurrent subscriptions to these {@code Publisher}s.
      * 

-     * 
+     * 
      * 

      * You can combine the items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3531,7 +3531,7 @@ public static  Flowable mergeArray(int maxConcurrency, int bufferSize, @No
     /**
      * Flattens an {@link Iterable} of {@link Publisher}s into one {@code Publisher}, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine the items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3577,7 +3577,7 @@ public static  Flowable merge(@NonNull Iterable<@NonNull ? extends Publish
      * Flattens an {@link Iterable} of {@link Publisher}s into one {@code Publisher}, without any transformation, while limiting the
      * number of concurrent subscriptions to these {@code Publisher}s.
      * 

-     * 
+     * 
      * 

      * You can combine the items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3627,7 +3627,7 @@ public static  Flowable merge(@NonNull Iterable<@NonNull ? extends Publish
      * Flattens a {@link Publisher} that emits {@code Publisher}s into a single {@code Publisher} that emits the items emitted by
      * thos {@code Publisher}s , without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine the items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3674,7 +3674,7 @@ public static  Flowable merge(@NonNull Publisher<@NonNull ? extends Publis
      * those {@code Publisher}s, without any transformation, while limiting the maximum number of concurrent
      * subscriptions to these {@code Publisher}s.
      * 

-     * 
+     * 
      * 

      * You can combine the items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3724,7 +3724,7 @@ public static  Flowable merge(@NonNull Publisher<@NonNull ? extends Publis
     /**
      * Flattens an array of {@link Publisher}s into one {@code Publisher}, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3770,7 +3770,7 @@ public static  Flowable mergeArray(@NonNull Publisher<@NonNull ? extends T
     /**
      * Flattens two {@link Publisher}s into a single {@code Publisher}, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3819,7 +3819,7 @@ public static  Flowable merge(@NonNull Publisher<@NonNull ? extends T> sou
     /**
      * Flattens three {@link Publisher}s into a single {@code Publisher}, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3871,7 +3871,7 @@ public static  Flowable merge(@NonNull Publisher<@NonNull ? extends T> sou
     /**
      * Flattens four {@link Publisher}s into a single {@code Publisher}, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by
      * using the {@code merge} method.
@@ -3934,7 +3934,7 @@ public static  Flowable merge(
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -3971,7 +3971,7 @@ public static  Flowable mergeDelayError(@NonNull Iterable<@NonNull ? exten
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4013,7 +4013,7 @@ public static  Flowable mergeDelayError(@NonNull Iterable<@NonNull ? exten
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4056,7 +4056,7 @@ public static  Flowable mergeArrayDelayError(int maxConcurrency, int buffe
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4096,7 +4096,7 @@ public static  Flowable mergeDelayError(@NonNull Iterable<@NonNull ? exten
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4134,7 +4134,7 @@ public static  Flowable mergeDelayError(@NonNull Publisher<@NonNull ? exte
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4175,7 +4175,7 @@ public static  Flowable mergeDelayError(@NonNull Publisher<@NonNull ? exte
      * error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from propagating that
      * error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4213,7 +4213,7 @@ public static  Flowable mergeArrayDelayError(@NonNull Publisher<@NonNull ?
      * notify of an error via {@link Subscriber#onError onError}, {@code mergeDelayError} will refrain from
      * propagating that error notification until all of the merged {@code Publisher}s have finished emitting items.
      * 

-     * 
+     * 
      * 

      * Even if both merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4255,7 +4255,7 @@ public static  Flowable mergeDelayError(@NonNull Publisher<@NonNull ? exte
      * from propagating that error notification until all of the merged {@code Publisher}s have finished emitting
      * items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4300,7 +4300,7 @@ public static  Flowable mergeDelayError(@NonNull Publisher<@NonNull ? exte
      * will refrain from propagating that error notification until all of the merged {@code Publisher}s have finished
      * emitting items.
      * 

-     * 
+     * 
      * 

      * Even if multiple merged {@code Publisher}s send {@code onError} notifications, {@code mergeDelayError} will only
      * invoke the {@code onError} method of its {@code Subscriber}s once.
@@ -4343,7 +4343,7 @@ public static  Flowable mergeDelayError(
     /**
      * Returns a {@code Flowable} that never sends any items or notifications to a {@link Subscriber}.
      * 

-     * 
+     * 
      * 

      * This {@link Publisher} is useful primarily for testing purposes.
      * 

@@ -4370,7 +4370,7 @@ public static  Flowable never() {
     /**
      * Returns a {@code Flowable} that emits a sequence of {@link Integer}s within a specified range.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals values on-demand (i.e., when requested).

@@ -4413,7 +4413,7 @@ public static Flowable range(int start, int count) {
     /**
      * Returns a {@code Flowable} that emits a sequence of {@link Long}s within a specified range.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and signals values on-demand (i.e., when requested).

@@ -4460,7 +4460,7 @@ public static Flowable rangeLong(long start, long count) {
      * Returns a {@link Single} that emits a {@link Boolean} value that indicates whether two {@link Publisher} sequences are the
      * same by comparing the items emitted by each {@code Publisher} pairwise.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator honors downstream backpressure and expects both of its sources
@@ -4492,7 +4492,7 @@ public static  Single sequenceEqual(@NonNull Publisher<@NonNull ? ex
      * same by comparing the items emitted by each {@code Publisher} pairwise based on the results of a specified
      * equality function.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The source {@code Publisher}s are expected to honor
@@ -4527,7 +4527,7 @@ public static  Single sequenceEqual(@NonNull Publisher<@NonNull ? ex
      * same by comparing the items emitted by each {@code Publisher} pairwise based on the results of a specified
      * equality function.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The source {@code Publisher}s are expected to honor
@@ -4568,7 +4568,7 @@ public static  Single sequenceEqual(@NonNull Publisher<@NonNull ? ex
      * Returns a {@link Single} that emits a {@link Boolean} value that indicates whether two {@link Publisher} sequences are the
      * same by comparing the items emitted by each {@code Publisher} pairwise.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator honors downstream backpressure and expects both of its sources
@@ -4602,7 +4602,7 @@ public static  Single sequenceEqual(@NonNull Publisher<@NonNull ? ex
      * Converts a {@link Publisher} that emits {@code Publisher}s into a {@code Publisher} that emits the items emitted by the
      * most recently emitted of those {@code Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code switchOnNext} subscribes to a {@code Publisher} that emits {@code Publisher}s. Each time it observes one of
      * these emitted {@code Publisher}s, the {@code Publisher} returned by {@code switchOnNext} begins emitting the items
@@ -4644,7 +4644,7 @@ public static  Flowable switchOnNext(@NonNull Publisher<@NonNull ? extends
      * Converts a {@link Publisher} that emits {@code Publisher}s into a {@code Publisher} that emits the items emitted by the
      * most recently emitted of those {@code Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code switchOnNext} subscribes to a {@code Publisher} that emits {@code Publisher}s. Each time it observes one of
      * these emitted {@code Publisher}s, the {@code Publisher} returned by {@code switchOnNext} begins emitting the items
@@ -4683,7 +4683,7 @@ public static  Flowable switchOnNext(@NonNull Publisher<@NonNull ? extends
      * Converts a {@link Publisher} that emits {@code Publisher}s into a {@code Publisher} that emits the items emitted by the
      * most recently emitted of those {@code Publisher}s and delays any exception until all {@code Publisher}s terminate.
      * 

-     * 
+     * 
      * 

      * {@code switchOnNext} subscribes to a {@code Publisher} that emits {@code Publisher}s. Each time it observes one of
      * these emitted {@code Publisher}s, the {@code Publisher} returned by {@code switchOnNext} begins emitting the items
@@ -4723,7 +4723,7 @@ public static  Flowable switchOnNextDelayError(@NonNull Publisher<@NonNull
      * Converts a {@link Publisher} that emits {@code Publisher}s into a {@code Publisher} that emits the items emitted by the
      * most recently emitted of those {@code Publisher}s and delays any exception until all {@code Publisher}s terminate.
      * 

-     * 
+     * 
      * 

      * {@code switchOnNext} subscribes to a {@code Publisher} that emits {@code Publisher}s. Each time it observes one of
      * these emitted {@code Publisher}s, the {@code Publisher} returned by {@code switchOnNext} begins emitting the items
@@ -4765,7 +4765,7 @@ public static  Flowable switchOnNextDelayError(@NonNull Publisher<@NonNull
     /**
      * Returns a {@code Flowable} that emits {@code 0L} after a specified delay, and then completes.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. If the downstream needs a slower rate
@@ -4794,7 +4794,7 @@ public static Flowable timer(long delay, @NonNull TimeUnit unit) {
      * Returns a {@code Flowable} that emits {@code 0L} after a specified delay, on a specified {@link Scheduler}, and then
      * completes.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. If the downstream needs a slower rate
@@ -4860,7 +4860,7 @@ public static  Flowable unsafeCreate(@NonNull Publisher onSubscribe) {
      * that resource and calls the provided {@code resourceDisposer} function if this inner source terminates or the
      * downstream cancels the flow.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator is a pass-through for backpressure and otherwise depends on the
@@ -4897,7 +4897,7 @@ public static  Flowable using(
      * that resource and calls the provided {@code resourceDisposer} function if this inner source terminates or the
      * downstream disposes the flow; doing it before these end-states have been reached if {@code eager == true}, after otherwise.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator is a pass-through for backpressure and otherwise depends on the
@@ -4963,7 +4963,7 @@ public static  Flowable using(
      * use {@link #doOnCancel(Action)} as well or use {@code using()} to do cleanup in case of completion
      * or cancellation.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects backpressure from the sources and honors backpressure from the downstream.
@@ -5018,7 +5018,7 @@ public static  Flowable zip(@NonNull Iterable<@NonNull ? extends Publis
      * use {@link #doOnCancel(Action)} as well or use {@code using()} to do cleanup in case of completion
      * or cancellation.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects backpressure from the sources and honors backpressure from the downstream.
@@ -5062,7 +5062,7 @@ public static  Flowable zip(@NonNull Iterable<@NonNull ? extends Publis
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * two items emitted, in sequence, by two other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by {@code o1} and the first item
@@ -5124,7 +5124,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * two items emitted, in sequence, by two other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by {@code o1} and the first item
@@ -5187,7 +5187,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * two items emitted, in sequence, by two other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by {@code o1} and the first item
@@ -5252,7 +5252,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * three items emitted, in sequence, by three other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by {@code o1}, the first item
@@ -5319,7 +5319,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * four items emitted, in sequence, by four other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by {@code o1}, the first item
@@ -5392,7 +5392,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * five items emitted, in sequence, by five other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by {@code o1}, the first item
@@ -5469,7 +5469,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * six items emitted, in sequence, by six other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by each source {@code Publisher}, the
@@ -5550,7 +5550,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * seven items emitted, in sequence, by seven other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by each source {@code Publisher}, the
@@ -5636,7 +5636,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * eight items emitted, in sequence, by eight other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by each source {@code Publisher}, the
@@ -5726,7 +5726,7 @@ public static  Flowable zip(
      * Returns a {@code Flowable} that emits the results of a specified combiner function applied to combinations of
      * nine items emitted, in sequence, by nine other {@link Publisher}s.
      * 

-     * 
+     * 
      * 

      * {@code zip} applies this function in strict sequence, so the first item emitted by the new {@code Publisher}
      * will be the result of the function applied to the first item emitted by each source {@code Publisher}, the
@@ -5843,7 +5843,7 @@ public static  Flowable zip(
      * use {@link #doOnCancel(Action)} as well or use {@code using()} to do cleanup in case of completion
      * or cancellation.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects backpressure from the sources and honors backpressure from the downstream.
@@ -5893,7 +5893,7 @@ public static  Flowable zipArray(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded
@@ -5921,7 +5921,7 @@ public final Single all(@NonNull Predicate predicate) {
      * Mirrors the {@link Publisher} (current or provided) that first either emits an item or sends a termination
      * notification.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator itself doesn't interfere with backpressure which is determined by the winning
@@ -5951,7 +5951,7 @@ public final Flowable ambWith(@NonNull Publisher<@NonNull ? extends T> other)
      * specified condition, otherwise {@code false}. Note: this always emits {@code false} if the
      * current {@code Flowable} is empty.
      * 

-     * 
+     * 
      * 

      * In Rx.Net this is the {@code any} operator but we renamed it in RxJava to better match Java naming
      * idioms.
@@ -6050,7 +6050,7 @@ public final T blockingFirst(@NonNull T defaultItem) {
      * {@link Consumer} with each upstream item on the current thread until the
      * upstream terminates.
      * 

-     * 
+     * 
      * 

      * Note: the method will only return if the upstream terminates or the current
      * thread is interrupted.
@@ -6091,7 +6091,7 @@ public final void blockingForEach(@NonNull Consumer onNext) {
      * {@link Consumer} with each upstream item on the current thread until the
      * upstream terminates.
      * 

-     * 
+     * 
      * 

      * Note: the method will only return if the upstream terminates or the current
      * thread is interrupted.
@@ -6142,7 +6142,7 @@ public final void blockingForEach(@NonNull Consumer onNext, int buffe
     /**
      * Converts this {@code Flowable} into an {@link Iterable}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to honor backpressure otherwise the returned
@@ -6165,7 +6165,7 @@ public final Iterable blockingIterable() {
     /**
      * Converts this {@code Flowable} into an {@link Iterable}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to honor backpressure otherwise the returned
@@ -6193,7 +6193,7 @@ public final Iterable blockingIterable(int bufferSize) {
      * Returns the last item emitted by this {@code Flowable}, or throws
      * {@link NoSuchElementException} if this {@code Flowable} emits no items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator consumes the current {@code Flowable} in an unbounded manner
@@ -6229,7 +6229,7 @@ public final T blockingLast() {
      * Returns the last item emitted by this {@code Flowable}, or a default value if it emits no
      * items.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator consumes the current {@code Flowable} in an unbounded manner
@@ -6292,7 +6292,7 @@ public final Iterable blockingLatest() {
      * Returns an {@link Iterable} that always returns the item most recently emitted by this
      * {@code Flowable}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator consumes the current {@code Flowable} in an unbounded manner
@@ -6321,7 +6321,7 @@ public final Iterable blockingMostRecent(@NonNull T initialItem) {
      * Returns an {@link Iterable} that blocks until this {@code Flowable} emits another item, then
      * returns that item.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator consumes the current {@code Flowable} in an unbounded manner
@@ -6345,7 +6345,7 @@ public final Iterable blockingNext() {
      * If this {@code Flowable} completes after emitting a single item, return that item, otherwise
      * throw a {@link NoSuchElementException}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator consumes the current {@code Flowable} in an unbounded manner
@@ -6374,7 +6374,7 @@ public final T blockingSingle() {
      * more than one item, throw an {@link IllegalArgumentException}; if it emits no items, return a default
      * value.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator consumes the current {@code Flowable} in an unbounded manner
@@ -6661,7 +6661,7 @@ public final void blockingSubscribe(@NonNull Subscriber<@NonNull ? super T> subs
      * current {@code Flowable}. Note that if the current {@code Flowable} issues an {@code onError} notification the event is passed on
      * immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and expects the current {@code Flowable} to honor it as
@@ -6692,7 +6692,7 @@ public final Flowable> buffer(int count) {
      * current {@code Flowable}. Note that if the current {@code Flowable} issues an {@code onError} notification the event is passed on
      * immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and expects the current {@code Flowable} to honor it as
@@ -6727,7 +6727,7 @@ public final Flowable> buffer(int count, int skip) {
      * current {@code Flowable}. Note that if the current {@code Flowable} issues an {@code onError} notification the event is passed on
      * immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and expects the current {@code Flowable} to honor it as
@@ -6770,7 +6770,7 @@ public final > Flowable buffer(int count, int
      * current {@code Flowable}. Note that if the current {@code Flowable} issues an {@code onError} notification the event is passed on
      * immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and expects the current {@code Flowable} to honor it as
@@ -6807,7 +6807,7 @@ public final > Flowable buffer(int count, @No
      * current {@code Flowable}. Note that if the current {@code Flowable} issues an {@code onError} notification the event is passed on
      * immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -6843,7 +6843,7 @@ public final Flowable> buffer(long timespan, long timeskip, @NonNull Tim
      * notification the event is passed on immediately without first emitting the buffer it is in the process of
      * assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -6881,7 +6881,7 @@ public final Flowable> buffer(long timespan, long timeskip, @NonNull Tim
      * notification the event is passed on immediately without first emitting the buffer it is in the process of
      * assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -6926,7 +6926,7 @@ public final > Flowable buffer(long timespan,
      * notification the event is passed on immediately without first emitting the buffer it is in the process of
      * assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -6960,7 +6960,7 @@ public final Flowable> buffer(long timespan, @NonNull TimeUnit unit) {
      * notification from the current {@code Flowable}. Note that if the current {@code Flowable} issues an {@code onError} notification the event
      * is passed on immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -6998,7 +6998,7 @@ public final Flowable> buffer(long timespan, @NonNull TimeUnit unit, int
      * current {@code Flowable} issues an {@code onError} notification the event is passed on immediately without first emitting the
      * buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -7038,7 +7038,7 @@ public final Flowable> buffer(long timespan, @NonNull TimeUnit unit, @No
      * current {@code Flowable} issues an {@code onError} notification the event is passed on immediately without first emitting the
      * buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -7091,7 +7091,7 @@ public final > Flowable buffer(
      * if the current {@code Flowable} issues an {@code onError} notification the event is passed on immediately without first emitting
      * the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it uses time. It requests {@link Long#MAX_VALUE}
@@ -7126,7 +7126,7 @@ public final Flowable> buffer(long timespan, @NonNull TimeUnit unit, @No
      * {@code PFlowable}, {@code openingIndicator} or {@code closingIndicator} issues an {@code onError} notification the event is passed
      * on immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it is instead controlled by the given {@code Publisher}s and
@@ -7163,7 +7163,7 @@ public final  Flowable> buffer(
      * {@code Flowable}, {@code openingIndicator} or {@code closingIndicator} issues an {@code onError} notification the event is passed
      * on immediately without first emitting the buffer it is in the process of assembling.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
This operator does not support backpressure as it is instead controlled by the given {@code Publisher}s and
@@ -7205,7 +7205,7 @@ public final > Flowable b
      * Returns a {@code Flowable} that emits non-overlapping buffered items from the current {@code Flowable} each time the
      * specified boundary {@link Publisher} emits an item.
      * 

-     * 
+     * 
      * 

      * Completion of either the source or the boundary {@code Publisher} causes the returned {@code Publisher} to emit the
      * latest buffer and complete. If either the current {@code Flowable} or the boundary {@code Publisher} issues an {@code onError} notification
@@ -7240,7 +7240,7 @@ public final  Flowable> buffer(@NonNull Publisher boundaryIndicato
      * Returns a {@code Flowable} that emits non-overlapping buffered items from the current {@code Flowable} each time the
      * specified boundary {@link Publisher} emits an item.
      * 

-     * 
+     * 
      * 

      * Completion of either the source or the boundary {@code Publisher} causes the returned {@code Publisher} to emit the
      * latest buffer and complete. If either the current {@code Flowable} or the boundary {@code Publisher} issues an {@code onError} notification
@@ -7279,7 +7279,7 @@ public final  Flowable> buffer(@NonNull Publisher boundaryIndicato
      * Returns a {@code Flowable} that emits non-overlapping buffered items from the current {@code Flowable} each time the
      * specified boundary {@link Publisher} emits an item.
      * 

-     * 
+     * 
      * 

      * Completion of either the source or the boundary {@code Publisher} causes the returned {@code Publisher} to emit the
      * latest buffer and complete. If either the current {@code Flowable} or the boundary {@code Publisher} issues an {@code onError} notification
@@ -7320,7 +7320,7 @@ public final > Flowable buffer(@NonNull Pu
      * Returns a {@code Flowable} that subscribes to this {@link Publisher} lazily, caches all of its events
      * and replays them, in the same order as received, to all the downstream subscribers.
      * 

-     * 
+     * 
      * 

      * This is useful when you want a {@code Publisher} to cache responses and you can't control the
      * subscribe/cancel behavior of all the {@link Subscriber}s.
@@ -7380,7 +7380,7 @@ public final Flowable cache() {
      * Returns a {@code Flowable} that subscribes to this {@link Publisher} lazily, caches all of its events
      * and replays them, in the same order as received, to all the downstream subscribers.
      * 

-     * 
+     * 
      * 

      * This is useful when you want a {@code Publisher} to cache responses and you can't control the
      * subscribe/cancel behavior of all the {@link Subscriber}s.
@@ -7446,7 +7446,7 @@ public final Flowable cacheWithInitialCapacity(int initialCapacity) {
      * Returns a {@code Flowable} that emits the items emitted by the current {@code Flowable}, converted to the specified
      * type.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -7476,7 +7476,7 @@ public final  Flowable cast(@NonNull Class clazz) {
      * Collects items emitted by the finite source {@link Publisher} into a single mutable data structure and returns
      * a {@link Single} that emits this structure.
      * 

-     * 
+     * 
      * 

      * This is a simplified version of {@code reduce} that does not need to return the state on each pass.
      * 

@@ -7516,7 +7516,7 @@ public final  Single collect(@NonNull Supplier initialItemSup
      * Collects items emitted by the finite source {@link Publisher} into a single mutable data structure and returns
      * a {@link Single} that emits this structure.
      * 

-     * 
+     * 
      * 

      * This is a simplified version of {@code reduce} that does not need to return the state on each pass.
      * 

@@ -7587,7 +7587,7 @@ public final  Flowable compose(@NonNull FlowableTransformer
-     * 
+     * 
      * 

      * Note that there is no guarantee where the given {@code mapper} function will be executed; it could be on the subscribing thread,
      * on the upstream thread signaling the new item to be mapped or on the thread where the inner source terminates. To ensure
@@ -7624,7 +7624,7 @@ public final  Flowable concatMap(@NonNull Function
-     * 
+     * 
      * 

      * Note that there is no guarantee where the given {@code mapper} function will be executed; it could be on the subscribing thread,
      * on the upstream thread signaling the new item to be mapped or on the thread where the inner source terminates. To ensure
@@ -7675,7 +7675,7 @@ public final  Flowable concatMap(@NonNull Function
-     * 
+     * 
      * 

      * The difference between {@link #concatMap(Function, int)} and this operator is that this operator guarantees the {@code mapper}
      * function is executed on the specified scheduler.
@@ -7721,7 +7721,7 @@ public final  Flowable concatMap(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure. If this {@code Flowable} violates the rule, the operator will
@@ -7750,7 +7750,7 @@ public final Completable concatMapCompletable(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure. If this {@code Flowable} violates the rule, the operator will
@@ -7787,7 +7787,7 @@ public final Completable concatMapCompletable(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure. If this {@code Flowable} violates the rule, the operator will
@@ -7817,7 +7817,7 @@ public final Completable concatMapCompletableDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure. If this {@code Flowable} violates the rule, the operator will
@@ -7853,7 +7853,7 @@ public final Completable concatMapCompletableDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure. If this {@code Flowable} violates the rule, the operator will
@@ -8233,7 +8233,7 @@ public final  Flowable concatMapIterable(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8266,7 +8266,7 @@ public final  Flowable concatMapMaybe(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8306,7 +8306,7 @@ public final  Flowable concatMapMaybe(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8339,7 +8339,7 @@ public final  Flowable concatMapMaybeDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8378,7 +8378,7 @@ public final  Flowable concatMapMaybeDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8423,7 +8423,7 @@ public final  Flowable concatMapMaybeDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8456,7 +8456,7 @@ public final  Flowable concatMapSingle(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8496,7 +8496,7 @@ public final  Flowable concatMapSingle(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8529,7 +8529,7 @@ public final  Flowable concatMapSingleDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8568,7 +8568,7 @@ public final  Flowable concatMapSingleDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator expects the upstream to support backpressure and honors
@@ -8612,7 +8612,7 @@ public final  Flowable concatMapSingleDelayError(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. Both this and the {@code other} {@link Publisher}s
@@ -8641,7 +8641,7 @@ public final Flowable concatWith(@NonNull Publisher<@NonNull ? extends T> oth
      * Returns a {@code Flowable} that emits the items from this {@code Flowable} followed by the success item or error event
      * of the other {@link SingleSource}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator supports backpressure and makes sure the success item of the other {@code SingleSource}
@@ -8668,7 +8668,7 @@ public final Flowable concatWith(@NonNull SingleSource other) {
      * Returns a {@code Flowable} that emits the items from this {@code Flowable} followed by the success item or terminal events
      * of the other {@link MaybeSource}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator supports backpressure and makes sure the success item of the other {@code MaybeSource}
@@ -8695,7 +8695,7 @@ public final Flowable concatWith(@NonNull MaybeSource other) {
      * Returns a {@code Flowable} that emits items from this {@code Flowable} and when it completes normally, the
      * other {@link CompletableSource} is subscribed to and the returned {@code Flowable} emits its terminal events.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator does not interfere with backpressure between the current {@code Flowable} and the
@@ -8724,7 +8724,7 @@ public final Flowable concatWith(@NonNull CompletableSource other) {
      * Returns a {@link Single} that emits a {@link Boolean} that indicates whether the current {@code Flowable} emitted a
      * specified item.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an
@@ -8752,7 +8752,7 @@ public final Single contains(@NonNull Object item) {
      * Returns a {@link Single} that counts the total number of items emitted by the current {@code Flowable} and emits
      * this count as a 64-bit {@link Long}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an
@@ -8776,7 +8776,7 @@ public final Single count() {
      * Returns a {@code Flowable} that mirrors the current {@code Flowable}, except that it drops items emitted by the
      * current {@code Flowable} that are followed by another item within a computed debounce duration.
      * 

-     * 
+     * 
      * 

      * The delivery of the item happens on the thread of the first {@code onNext} or {@code onComplete}
      * signal of the generated {@link Publisher} sequence,
@@ -8819,7 +8819,7 @@ public final  Flowable debounce(@NonNull FunctionNote: If items keep being emitted by the current {@code Flowable} faster than the timeout then no items
      * will be emitted by the resulting {@code Flowable}.
      * 

-     * 
+     * 
      * 

      * Delivery of the item after the grace period happens on the {@code computation} {@link Scheduler}'s
      * {@code Worker} which if takes too long, a newer item may arrive from the upstream, causing the
@@ -8862,7 +8862,7 @@ public final Flowable debounce(long timeout, @NonNull TimeUnit unit) {
      * Note: If items keep being emitted by the current {@code Flowable} faster than the timeout then no items
      * will be emitted by the resulting {@code Flowable}.
      * 

-     * 
+     * 
      * 

      * Delivery of the item after the grace period happens on the given {@code Scheduler}'s
      * {@code Worker} which if takes too long, a newer item may arrive from the upstream, causing the
@@ -8905,7 +8905,7 @@ public final Flowable debounce(long timeout, @NonNull TimeUnit unit, @NonNull
      * Returns a {@code Flowable} that emits the items emitted by the current {@code Flowable} or a specified default item
      * if the current {@code Flowable} is empty.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
If the current {@code Flowable} is empty, this operator is guaranteed to honor backpressure from downstream.
@@ -8935,7 +8935,7 @@ public final Flowable defaultIfEmpty(@NonNull T defaultItem) {
      * Returns a {@code Flowable} that delays the emissions of the current {@code Flowable} via another {@link Publisher} on a
      * per-item basis.
      * 

-     * 
+     * 
      * 

      * Note: the resulting {@code Flowable} will immediately propagate any {@code onError} notification
      * from the current {@code Flowable}.
@@ -8971,7 +8971,7 @@ public final  Flowable delay(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with the backpressure behavior which is determined by the current {@code Flowable}.

@@ -8999,7 +8999,7 @@ public final Flowable delay(long time, @NonNull TimeUnit unit) {
      * Returns a {@code Flowable} that emits the items emitted by the current {@code Flowable} shifted forward in time by a
      * specified delay. If {@code delayError} is {@code true}, error notifications will also be delayed.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with the backpressure behavior which is determined by the current {@code Flowable}.

@@ -9030,7 +9030,7 @@ public final Flowable delay(long time, @NonNull TimeUnit unit, boolean delayE
      * Returns a {@code Flowable} that emits the items emitted by the current {@code Flowable} shifted forward in time by a
      * specified delay. The {@code onError} notification from the current {@code Flowable} is not delayed.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with the backpressure behavior which is determined by the current {@code Flowable}.

@@ -9060,7 +9060,7 @@ public final Flowable delay(long time, @NonNull TimeUnit unit, @NonNull Sched
      * Returns a {@code Flowable} that emits the items emitted by the current {@code Flowable} shifted forward in time by a
      * specified delay. If {@code delayError} is {@code true}, error notifications will also be delayed.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with the backpressure behavior which is determined by the current {@code Flowable}.

@@ -9096,7 +9096,7 @@ public final Flowable delay(long time, @NonNull TimeUnit unit, @NonNull Sched
      * Returns a {@code Flowable} that delays the subscription to and emissions from the current {@code Flowable} via another
      * {@link Publisher} on a per-item basis.
      * 

-     * 
+     * 
      * 

      * Note: the resulting {@code Flowable} will immediately propagate any {@code onError} notification
      * from the current {@code Flowable}.
@@ -9163,7 +9163,7 @@ public final  Flowable delaySubscription(@NonNull Publisher subscriptio
     /**
      * Returns a {@code Flowable} that delays the subscription to the current {@code Flowable} by a given amount of time.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with the backpressure behavior which is determined by the current {@code Flowable}.

@@ -9191,7 +9191,7 @@ public final Flowable delaySubscription(long time, @NonNull TimeUnit unit) {
      * Returns a {@code Flowable} that delays the subscription to the current {@code Flowable} by a given amount of time,
      * both waiting and subscribing on a given {@link Scheduler}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with the backpressure behavior which is determined by the current {@code Flowable}.

@@ -9222,7 +9222,7 @@ public final Flowable delaySubscription(long time, @NonNull TimeUnit unit, @N
      * {@link Notification} objects extracted from the source items via a selector function
      * into their respective {@link Subscriber} signal types.
      * 

-     * 
+     * 
      * 

      * The intended use of the {@code selector} function is to perform a
      * type-safe identity mapping (see example) on a source that is already of type
@@ -9280,7 +9280,7 @@ public final  Flowable dematerialize(@NonNull Function<@NonNull ? super T,
      * Returns a {@code Flowable} that emits all items emitted by the current {@code Flowable} that are distinct
      * based on {@link Object#equals(Object)} comparison.
      * 

-     * 
+     * 
      * 

      * It is recommended the elements' class {@code T} in the flow overrides the default {@code Object.equals()} and {@link Object#hashCode()} to provide
      * a meaningful comparison between items as the default Java implementation only considers reference equivalence.
@@ -9322,7 +9322,7 @@ public final Flowable distinct() {
      * to a key selector function and based on {@link Object#equals(Object)} comparison of the objects
      * returned by the key selector function.
      * 

-     * 
+     * 
      * 

      * It is recommended the keys' class {@code K} overrides the default {@code Object.equals()} and {@link Object#hashCode()} to provide
      * a meaningful comparison between the key objects as the default Java implementation only considers reference equivalence.
@@ -9367,7 +9367,7 @@ public final  Flowable distinct(@NonNull Function keySelecto
      * to a key selector function and based on {@link Object#equals(Object)} comparison of the objects
      * returned by the key selector function.
      * 

-     * 
+     * 
      * 

      * It is recommended the keys' class {@code K} overrides the default {@code Object.equals()} and {@link Object#hashCode()} to provide
      * a meaningful comparison between the key objects as the default Java implementation only considers reference equivalence.
@@ -9405,7 +9405,7 @@ public final  Flowable distinct(@NonNull Function keySelecto
      * Returns a {@code Flowable} that emits all items emitted by the current {@code Flowable} that are distinct from their
      * immediate predecessors based on {@link Object#equals(Object)} comparison.
      * 

-     * 
+     * 
      * 

      * It is recommended the elements' class {@code T} in the flow overrides the default {@code Object.equals()} to provide
      * a meaningful comparison between items as the default Java implementation only considers reference equivalence.
@@ -9447,7 +9447,7 @@ public final Flowable distinctUntilChanged() {
      * immediate predecessors, according to a key selector function and based on {@link Object#equals(Object)} comparison
      * of those objects returned by the key selector function.
      * 

-     * 
+     * 
      * 

      * It is recommended the keys' class {@code K} overrides the default {@code Object.equals()} to provide
      * a meaningful comparison between the key objects as the default Java implementation only considers reference equivalence.
@@ -9494,7 +9494,7 @@ public final  Flowable distinctUntilChanged(@NonNull Function
-     * 
+     * 
      * 

      * Note that the operator always retains the latest item from upstream regardless of the comparison result
      * and uses it in the next comparison with the next upstream item.
@@ -9594,7 +9594,7 @@ public final Flowable doAfterNext(@NonNull Consumer onAfterNext) {
      * Registers an {@link Action} to be called when this {@link Publisher} invokes either
      * {@link Subscriber#onComplete onComplete} or {@link Subscriber#onError onError}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure
@@ -9622,7 +9622,7 @@ public final Flowable doAfterTerminate(@NonNull Action onAfterTerminate) {
     /**
      * Calls the cancel {@link Action} if the downstream cancels the sequence.
      * 

-     * 
+     * 
      * 

      * The action is shared between subscriptions and thus may be called concurrently from multiple
      * threads; the action must be thread-safe.
@@ -9654,7 +9654,7 @@ public final Flowable doOnCancel(@NonNull Action onCancel) {
     /**
      * Invokes an {@link Action} just before the current {@code Flowable} calls {@code onComplete}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9682,7 +9682,7 @@ public final Flowable doOnComplete(@NonNull Action onComplete) {
      * Calls the appropriate onXXX consumer (shared between all subscribers) whenever a signal with the same type
      * passes through, before forwarding them to downstream.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9712,7 +9712,7 @@ private Flowable doOnEach(@NonNull Consumer onNext, @NonNull Consu
      * Invokes a {@link Consumer} with a {@link Notification} instances matching the signals emitted by the current {@code Flowable}
      * before they are forwarded to the downstream.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9750,7 +9750,7 @@ public final Flowable doOnEach(@NonNull Consumer<@NonNull ? super Notificatio
      * {@code onNext} or the {@code onComplete} method of the supplied {@code Subscriber} throws, the downstream will be
      * terminated and will receive this thrown exception.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9786,7 +9786,7 @@ public final Flowable doOnEach(@NonNull Subscriber<@NonNull ? super T> subscr
      * In case the {@code onError} action throws, the downstream will receive a composite exception containing
      * the original exception and the exception thrown by {@code onError}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9814,7 +9814,7 @@ public final Flowable doOnError(@NonNull Consumer onError)
      * Calls the appropriate {@code onXXX} method (shared between all {@link Subscriber}s) for the lifecycle events of
      * the sequence (subscription, cancellation, requesting).
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9848,7 +9848,7 @@ public final Flowable doOnLifecycle(@NonNull Consumer o
     /**
      * Calls the given {@link Consumer} with the value emitted by the current {@code Flowable} before forwarding it to the downstream.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9909,7 +9909,7 @@ public final Flowable doOnRequest(@NonNull LongConsumer onRequest) {
      * subscription from the downstream before forwarding it to the subscriber's
      * {@link Subscriber#onSubscribe(Subscription) onSubscribe} method.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s
@@ -9936,7 +9936,7 @@ public final Flowable doOnSubscribe(@NonNull Consumer o
      * Calls the given {@link Action} when the current {@code Flowable} completes normally or with an error before those signals
      * are forwarded to the downstream.
      * 

-     * 
+     * 
      * 

      * This differs from {@code doAfterTerminate} in that this happens before the {@code onComplete} or
      * {@code onError} notification.
@@ -9968,7 +9968,7 @@ public final Flowable doOnTerminate(@NonNull Action onTerminate) {
      * Returns a {@link Maybe} that emits the single item at a specified index in a sequence of emissions from
      * this {@code Flowable} or completes if this {@code Flowable} sequence has fewer elements than index.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and consumes the current {@code Flowable} in a bounded manner.

@@ -9997,7 +9997,7 @@ public final Maybe elementAt(long index) {
      * Returns a {@link Single} that emits the item found at a specified index in a sequence of emissions from
      * this {@code Flowable}, or a default item if that index is out of range.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and consumes the current {@code Flowable} in a bounded manner.

@@ -10031,7 +10031,7 @@ public final Single elementAt(long index, @NonNull T defaultItem) {
      * Returns a {@link Single} that emits the item found at a specified index in a sequence of emissions from
      * this {@code Flowable} or signals a {@link NoSuchElementException} if this {@code Flowable} has fewer elements than index.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream and consumes the current {@code Flowable} in a bounded manner.

@@ -10060,7 +10060,7 @@ public final Single elementAtOrError(long index) {
     /**
      * Filters items emitted by the current {@code Flowable} by only emitting those that satisfy a specified predicate.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure
@@ -10162,7 +10162,7 @@ public final Single firstOrError() {
      * by the current {@code Flowable}, where that function returns a {@link Publisher}, and then merging those resulting
      * {@code Publisher}s and emitting the results of this merger.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10194,7 +10194,7 @@ public final  Flowable flatMap(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10230,7 +10230,7 @@ public final  Flowable flatMap(@NonNull Function -->
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10267,7 +10267,7 @@ public final  Flowable flatMap(@NonNull Function -->
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10307,7 +10307,7 @@ public final  Flowable flatMap(@NonNull Function -->
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10359,7 +10359,7 @@ public final  Flowable flatMap(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10403,7 +10403,7 @@ public final  Flowable flatMap(
      * {@code Flowable} and then flattens the {@link Publisher}s returned from these functions and emits the resulting items,
      * while limiting the maximum number of concurrent subscriptions to these {@code Publisher}s.
      * 
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10452,7 +10452,7 @@ public final  Flowable flatMap(
      * Returns a {@code Flowable} that emits the results of a specified function to the pair of values emitted by the
      * current {@code Flowable} and a specified collection {@link Publisher}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10489,7 +10489,7 @@ public final  Flowable flatMap(@NonNull Function
-     * 
+     * 
      * 

      * 
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10530,7 +10530,7 @@ public final  Flowable flatMap(@NonNull Function -->
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10575,7 +10575,7 @@ public final  Flowable flatMap(@NonNull Function -->
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -10626,7 +10626,7 @@ public final  Flowable flatMap(@NonNull Function -->
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The operator honors backpressure from downstream. The upstream {@code Flowable} is consumed
@@ -11104,7 +11104,7 @@ public final Disposable forEachWhile(@NonNull Predicate onNext, @NonN
      * source terminates, the next emission by the source having the same key will trigger a new
      * {@code GroupedFlowable} emission.
      * 

-     * 
+     * 
      * 

      * Note: A {@code GroupedFlowable} will cache the items it is to emit until such time as it
      * is subscribed to. For this reason, in order to avoid memory leaks, you should not simply ignore those
@@ -11162,7 +11162,7 @@ public final  Flowable> groupBy(@NonNull Function
-     * 
+     * 
      * 

      * Note: A {@code GroupedFlowable} will cache the items it is to emit until such time as it
      * is subscribed to. For this reason, in order to avoid memory leaks, you should not simply ignore those
@@ -11221,7 +11221,7 @@ public final  Flowable> groupBy(@NonNull Function
-     * 
+     * 
      * 

      * Note: A {@code GroupedFlowable} will cache the items it is to emit until such time as it
      * is subscribed to. For this reason, in order to avoid memory leaks, you should not simply ignore those
@@ -11285,7 +11285,7 @@ public final  Flowable> groupBy(@NonNull Function
-     * 
+     * 
      * 

      * Note: A {@code GroupedFlowable} will cache the items it is to emit until such time as it
      * is subscribed to. For this reason, in order to avoid memory leaks, you should not simply ignore those
@@ -11350,7 +11350,7 @@ public final  Flowable> groupBy(@NonNull Function
-     * 
+     * 
      * 

      * Note: A {@code GroupedFlowable} will cache the items it is to emit until such time as it
      * is subscribed to. For this reason, in order to avoid memory leaks, you should not simply ignore those
@@ -11463,7 +11463,7 @@ public final  Flowable> groupBy(@NonNull Function
* *

- * + * *

* Note: A {@code GroupedFlowable} will cache the items it is to emit until such time as it * is subscribed to. For this reason, in order to avoid memory leaks, you should not simply ignore those @@ -11544,7 +11544,7 @@ public final Flowable> groupBy(@NonNull Function - * + * *

*
Backpressure:
*
The operator doesn't support backpressure and consumes all participating {@code Publisher}s in @@ -11616,7 +11616,7 @@ public final Flowable hide() { /** * Ignores all items emitted by the current {@code Flowable} and only calls {@code onComplete} or {@code onError}. *

- * + * *

*
Backpressure:
*
This operator ignores backpressure as it doesn't emit any elements and consumes the current {@code Flowable} @@ -11642,7 +11642,7 @@ public final Completable ignoreElements() { * In Rx.Net this is negated as the {@code any} {@link Subscriber} but we renamed this in RxJava to better match Java * naming idioms. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -11668,7 +11668,7 @@ public final Single isEmpty() { * There are no guarantees in what order the items get combined when multiple * items from one or both source {@code Publisher}s overlap. *

- * + * *

*
Backpressure:
*
The operator doesn't support backpressure and consumes all participating {@code Publisher}s in @@ -11717,7 +11717,7 @@ public final Flowable join( * Returns a {@link Maybe} that emits the last item emitted by this {@code Flowable} or completes if * this {@code Flowable} is empty. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -11741,7 +11741,7 @@ public final Maybe lastElement() { * Returns a {@link Single} that emits only the last item emitted by this {@code Flowable}, or a default item * if this {@code Flowable} completes without emitting any items. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -11949,7 +11949,7 @@ public final Flowable lift(@NonNull FlowableOperator - * + * *
*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -11979,7 +11979,7 @@ public final Flowable lift(@NonNull FlowableOperatorand notifications from the current * {@code Flowable} into emissions marked with their original types within {@link Notification} objects. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and expects it from the current {@code Flowable}. @@ -12003,7 +12003,7 @@ public final Flowable> materialize() { /** * Flattens this and another {@link Publisher} into a single {@code Publisher}, without any transformation. *

- * + * *

* You can combine items emitted by multiple {@code Publisher}s so that they appear as a single {@code Publisher}, by * using the {@code mergeWith} method. @@ -12033,7 +12033,7 @@ public final Flowable mergeWith(@NonNull Publisher<@NonNull ? extends T> othe /** * Merges the sequence of items of this {@code Flowable} with the success value of the other {@link SingleSource}. *

- * + * *

* The success value of the other {@code SingleSource} can get interleaved at any point of this * {@code Flowable} sequence. @@ -12063,7 +12063,7 @@ public final Flowable mergeWith(@NonNull SingleSource other) { * Merges the sequence of items of this {@code Flowable} with the success value of the other {@link MaybeSource} * or waits for both to complete normally if the {@code MaybeSource} is empty. *

- * + * *

* The success value of the other {@code MaybeSource} can get interleaved at any point of this * {@code Flowable} sequence. @@ -12093,7 +12093,7 @@ public final Flowable mergeWith(@NonNull MaybeSource other) { * Relays the items of this {@code Flowable} and completes only when the other {@link CompletableSource} completes * as well. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -12123,7 +12123,7 @@ public final Flowable mergeWith(@NonNull CompletableSource other) { *

Note that {@code onError} notifications will cut ahead of {@code onNext} notifications on the emission thread if {@code Scheduler} is truly * asynchronous. If strict event ordering is required, consider using the {@link #observeOn(Scheduler, boolean)} overload. *

- * + * *

* This operator keeps emitting as many signals as it can on the given {@code Scheduler}'s Worker thread, * which may result in a longer than expected occupation of this thread. In other terms, @@ -12171,7 +12171,7 @@ public final Flowable observeOn(@NonNull Scheduler scheduler) { * Signals the items and terminal signals of the current {@code Flowable} on the specified {@link Scheduler}, * asynchronously with a bounded buffer and optionally delays {@code onError} notifications. *

- * + * *

* This operator keeps emitting as many signals as it can on the given {@code Scheduler}'s Worker thread, * which may result in a longer than expected occupation of this thread. In other terms, @@ -12223,7 +12223,7 @@ public final Flowable observeOn(@NonNull Scheduler scheduler, boolean delayEr * Signals the items and terminal signals of the current {@code Flowable} on the specified {@link Scheduler}, * asynchronously with a bounded buffer of configurable size and optionally delays {@code onError} notifications. *

- * + * *

* This operator keeps emitting as many signals as it can on the given {@code Scheduler}'s Worker thread, * which may result in a longer than expected occupation of this thread. In other terms, @@ -12278,7 +12278,7 @@ public final Flowable observeOn(@NonNull Scheduler scheduler, boolean delayEr /** * Filters the items emitted by the current {@code Flowable}, only emitting those of the specified type. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -12307,7 +12307,7 @@ public final Flowable ofType(@NonNull Class clazz) { * Buffers an unlimited number of items from the current {@code Flowable} and allows it to emit as fast it can while allowing the * downstream to consume the items at its own place. *

- * + * *

* An error from the current {@code Flowable} will cut ahead of any unconsumed item. Use {@link #onBackpressureBuffer(boolean)} * to have the operator keep the original signal order. @@ -12335,7 +12335,7 @@ public final Flowable onBackpressureBuffer() { * Buffers an unlimited number of items from the current {@code Flowable} and allows it to emit as fast it can while allowing the * downstream to consume the items at its own place, optionally delaying an error until all buffered items have been consumed. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded @@ -12364,7 +12364,7 @@ public final Flowable onBackpressureBuffer(boolean delayError) { * {@link MissingBackpressureException} via {@code onError} as soon as the buffer's capacity is exceeded, dropping all undelivered * items, and canceling the flow. *

- * + * *

* An error from the current {@code Flowable} will cut ahead of any unconsumed item. Use {@link #onBackpressureBuffer(int, boolean)} * to have the operator keep the original signal order. @@ -12397,7 +12397,7 @@ public final Flowable onBackpressureBuffer(int capacity) { * {@link MissingBackpressureException} via {@code onError} as soon as the buffer's capacity is exceeded, dropping all undelivered * items, and canceling the flow. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded @@ -12431,7 +12431,7 @@ public final Flowable onBackpressureBuffer(int capacity, boolean delayError) * {@link MissingBackpressureException} via {@code onError} as soon as the buffer's capacity is exceeded, dropping all undelivered * items, and canceling the flow. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded @@ -12468,7 +12468,7 @@ public final Flowable onBackpressureBuffer(int capacity, boolean delayError, * {@link MissingBackpressureException} via {@code onError} as soon as the buffer's capacity is exceeded, dropping all undelivered * items, canceling the flow and calling the {@code onOverflow} action. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded @@ -12508,7 +12508,7 @@ public final Flowable onBackpressureBuffer(int capacity, boolean delayError, * {@link MissingBackpressureException} via {@code onError} as soon as the buffer's capacity is exceeded, dropping all undelivered * items, canceling the flow and calling the {@code onOverflow} action. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded @@ -12549,7 +12549,7 @@ public final Flowable onBackpressureBuffer(int capacity, @NonNull Action onOv * * *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an unbounded @@ -12581,7 +12581,7 @@ public final Flowable onBackpressureBuffer(long capacity, @Nullable Action on * Drops items from the current {@code Flowable} if the downstream is not ready to receive new items (indicated * by a lack of {@link Subscription#request(long)} calls from it). *

- * + * *

* If the downstream request count hits 0 then the resulting {@code Flowable} will refrain from calling {@code onNext} until * the {@link Subscriber} invokes {@code request(n)} again to increase the request count. @@ -12609,7 +12609,7 @@ public final Flowable onBackpressureDrop() { * by a lack of {@link Subscription#request(long)} calls from it) and calls the given {@link Consumer} with such * dropped items. *

- * + * *

* If the downstream request count hits 0 then the resulting {@code Flowable} will refrain from calling {@code onNext} until * the {@link Subscriber} invokes {@code request(n)} again to increase the request count. @@ -12641,7 +12641,7 @@ public final Flowable onBackpressureDrop(@NonNull Consumer onDrop) * new items (indicated by a lack of {@link Subscription#request(long)} calls from it) and emits this latest * item when the downstream becomes ready. *

- * + * *

* Its behavior is logically equivalent to {@code blockingLatest()} with the exception that * the downstream is not blocking while requesting more values. @@ -12725,7 +12725,7 @@ public final Flowable onErrorComplete(@NonNull Predicate p * Resumes the flow with a {@link Publisher} returned for the failure {@link Throwable} of the current {@code Flowable} by a * function instead of signaling the error via {@code onError}. *

- * + * *

* By default, when a {@code Publisher} encounters an error that prevents it from emitting the expected item to * its {@link Subscriber}, the {@code Publisher} invokes its {@code Subscriber}'s {@code onError} method, and then quits @@ -12770,7 +12770,7 @@ public final Flowable onErrorResumeNext(@NonNull Function - * + * *

* By default, when a {@code Publisher} encounters an error that prevents it from emitting the expected item to * its {@link Subscriber}, the {@code Publisher} invokes its {@code Subscriber}'s {@code onError} method, and then quits @@ -12815,7 +12815,7 @@ public final Flowable onErrorResumeWith(@NonNull Publisher<@NonNull ? extends * Ends the flow with a last item returned by a function for the {@link Throwable} error signaled by the current * {@code Flowable} instead of signaling the error via {@code onError}. *

- * + * *

* By default, when a {@link Publisher} encounters an error that prevents it from emitting the expected item to * its {@link Subscriber}, the {@code Publisher} invokes its {@code Subscriber}'s {@code onError} method, and then quits @@ -12855,7 +12855,7 @@ public final Flowable onErrorReturn(@NonNull Function - * + * *

* By default, when a {@link Publisher} encounters an error that prevents it from emitting the expected item to * its {@link Subscriber}, the {@code Publisher} invokes its {@code Subscriber}'s {@code onError} method, and then quits @@ -13015,7 +13015,7 @@ public final ParallelFlowable parallel(int parallelism, int prefetch) { * {@link ConnectableFlowable#connect connect} method is called before it begins emitting items to those * {@link Subscriber}s that have subscribed to it. *

- * + * *

*
Backpressure:
*
The returned {@code ConnectableFlowable} honors backpressure for each of its {@code Subscriber}s @@ -13040,7 +13040,7 @@ public final ConnectableFlowable publish() { * Returns a {@code Flowable} that emits the results of invoking a specified selector on items emitted by a * {@link ConnectableFlowable} that shares a single subscription to the underlying sequence. *

- * + * *

*
Backpressure:
*
The operator expects the current {@code Flowable} to honor backpressure and if this expectation is @@ -13074,7 +13074,7 @@ public final Flowable publish(@NonNull Function, ? ex * Returns a {@code Flowable} that emits the results of invoking a specified selector on items emitted by a * {@link ConnectableFlowable} that shares a single subscription to the underlying sequence. *

- * + * *

*
Backpressure:
*
The operator expects the current {@code Flowable} to honor backpressure and if this expectation is @@ -13114,7 +13114,7 @@ public final Flowable publish(@NonNull Function, ? ex * {@link ConnectableFlowable#connect connect} method is called before it begins emitting items to those * {@link Subscriber}s that have subscribed to it. *

- * + * *

*
Backpressure:
*
The returned {@code ConnectableFlowable} honors backpressure for each of its {@code Subscriber}s @@ -13172,7 +13172,7 @@ public final Flowable rebatchRequests(int n) { * {@code Flowable} into the same function, and so on until all items have been emitted by the current and finite {@code Flowable}, * and emits the final result from the final call to your function as its sole item. *

- * + * *

* This technique, which is called "reduce" here, is sometimes called "aggregate," "fold," "accumulate," * "compress," or "inject" in other programming contexts. Groovy, for instance, has an {@code inject} method @@ -13212,7 +13212,7 @@ public final Maybe reduce(@NonNull BiFunction reducer) { * emitted by the current {@code Flowable} into the same function, and so on until all items have been emitted by the * current and finite {@code Flowable}, emitting the final result from the final call to your function as its sole item. *

- * + * *

* This technique, which is called "reduce" here, is sometimes called "aggregate," "fold," "accumulate," * "compress," or "inject" in other programming contexts. Groovy, for instance, has an {@code inject} method @@ -13276,7 +13276,7 @@ public final Maybe reduce(@NonNull BiFunction reducer) { * all items have been emitted by the current and finite {@code Flowable}, emitting the final result from the final call to your * function as its sole item. *

- * + * *

* This technique, which is called "reduce" here, is sometimes called "aggregate", "fold", "accumulate", * "compress", or "inject" in other programming contexts. Groovy, for instance, has an {@code inject} method @@ -13317,7 +13317,7 @@ public final Maybe reduce(@NonNull BiFunction reducer) { /** * Returns a {@code Flowable} that repeats the sequence of items emitted by the current {@code Flowable} indefinitely. *

- * + * *

*
Backpressure:
*
The operator honors downstream backpressure and expects the current {@code Flowable} to honor backpressure as well. @@ -13341,7 +13341,7 @@ public final Flowable repeat() { * Returns a {@code Flowable} that repeats the sequence of items emitted by the current {@code Flowable} at most * {@code count} times. *

- * + * *

*
Backpressure:
*
The operator honors downstream backpressure and expects the current {@code Flowable} to honor backpressure as well. @@ -13376,7 +13376,7 @@ public final Flowable repeat(long times) { * Returns a {@code Flowable} that repeats the sequence of items emitted by the current {@code Flowable} until * the provided stop function returns {@code true}. *

- * + * *

*
Backpressure:
*
The operator honors downstream backpressure and expects the current {@code Flowable} to honor backpressure as well. @@ -13410,7 +13410,7 @@ public final Flowable repeatUntil(@NonNull BooleanSupplier stop) { * call {@code onComplete} or {@code onError} on the child subscription. Otherwise, this {@code Publisher} will * resubscribe to the current {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator honors downstream backpressure and expects the current {@code Flowable} to honor backpressure as well. @@ -13440,7 +13440,7 @@ public final Flowable repeatWhen(@NonNull Function, * {@code Flowable} resembles an ordinary {@code Flowable}, except that it does not begin emitting items when it is * subscribed to, but only when its {@code connect} method is called. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13465,7 +13465,7 @@ public final ConnectableFlowable replay() { * Returns a {@code Flowable} that emits items that are the results of invoking a specified selector on the items * emitted by a {@link ConnectableFlowable} that shares a single subscription to the current {@code Flowable}. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13501,7 +13501,7 @@ public final Flowable replay(@NonNull Function, ? ext * Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13542,7 +13542,7 @@ public final Flowable replay(@NonNull Function, ? ext * Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13585,7 +13585,7 @@ public final Flowable replay(@NonNull Function, ? ext * Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13627,7 +13627,7 @@ public final Flowable replay(@NonNull Function, ? ext * Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13678,7 +13678,7 @@ public final Flowable replay(@NonNull Function, ? ext * Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13728,7 +13728,7 @@ public final Flowable replay(@NonNull Function, ? ext * emitted by a {@link ConnectableFlowable} that shares a single subscription to the current {@code Flowable}, * replaying all items that were emitted within a specified time window. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13764,7 +13764,7 @@ public final Flowable replay(@NonNull Function, ? ext * emitted by a {@link ConnectableFlowable} that shares a single subscription to the current {@code Flowable}, * replaying all items that were emitted within a specified time window. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13806,7 +13806,7 @@ public final Flowable replay(@NonNull Function, ? ext * emitted by a {@link ConnectableFlowable} that shares a single subscription to the current {@code Flowable}, * replaying all items that were emitted within a specified time window. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13856,7 +13856,7 @@ public final Flowable replay(@NonNull Function, ? ext * To ensure no beyond-bufferSize items are referenced, * use the {@link #replay(int, boolean)} overload with {@code eagerTruncate = true}. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -13887,7 +13887,7 @@ public final ConnectableFlowable replay(int bufferSize) { * an ordinary {@code Flowable}, except that it does not begin emitting items when it is subscribed to, but only * when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -13926,7 +13926,7 @@ public final ConnectableFlowable replay(int bufferSize, boolean eagerTruncate * {@code Flowable} resembles an ordinary {@code Flowable}, except that it does not begin emitting items when it is * subscribed to, but only when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -13967,7 +13967,7 @@ public final ConnectableFlowable replay(int bufferSize, long time, @NonNull T * connectable {@code Flowable} resembles an ordinary {@code Flowable}, except that it does not begin emitting items * when it is subscribed to, but only when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -14017,7 +14017,7 @@ public final ConnectableFlowable replay(int bufferSize, long time, @NonNull T * {@code bufferSize} source emissions. To ensure no out-of-date or beyond-bufferSize items * are referenced, set {@code eagerTruncate = true}. *

- * + * *

*
Backpressure:
*
This operator supports backpressure. Note that the upstream requests are determined by the child @@ -14061,7 +14061,7 @@ public final ConnectableFlowable replay(int bufferSize, long time, @NonNull T * resembles an ordinary {@code Flowable}, except that it does not begin emitting items when it is subscribed to, * but only when its {@code connect} method is called. *

- * + * *

* Note that the internal buffer may retain strong references to the oldest item. To ensure no out-of-date items * are referenced, use the {@link #replay(long, TimeUnit, Scheduler, boolean)} overload with {@code eagerTruncate = true}. @@ -14096,7 +14096,7 @@ public final ConnectableFlowable replay(long time, @NonNull TimeUnit unit) { * resembles an ordinary {@code Flowable}, except that it does not begin emitting items when it is subscribed to, * but only when its {@code connect} method is called. *

- * + * *

* Note that the internal buffer may retain strong references to the oldest item. To ensure no out-of-date items * are referenced, use the {@link #replay(long, TimeUnit, Scheduler, boolean)} overload with {@code eagerTruncate = true}. @@ -14136,7 +14136,7 @@ public final ConnectableFlowable replay(long time, @NonNull TimeUnit unit, @N * resembles an ordinary {@code Flowable}, except that it does not begin emitting items when it is subscribed to, * but only when its {@code connect} method is called. *

- * + * *

* Note that the internal buffer may retain strong references to the oldest item. To ensure no out-of-date items * are referenced, set {@code eagerTruncate = true}. @@ -14176,7 +14176,7 @@ public final ConnectableFlowable replay(long time, @NonNull TimeUnit unit, @N * Returns a {@code Flowable} that mirrors the current {@code Flowable}, resubscribing to it if it calls {@code onError} * (infinite retry count). *

- * + * *

* If the current {@code Flowable} calls {@link Subscriber#onError}, this method will resubscribe to the current * {@code Flowable} rather than propagating the {@code onError} call. @@ -14208,7 +14208,7 @@ public final Flowable retry() { * Returns a {@code Flowable} that mirrors the current {@code Flowable}, resubscribing to it if it calls {@code onError} * and the predicate returns {@code true} for that specific exception and retry count. *

- * + * *

*
Backpressure:
*
The operator honors downstream backpressure and expects the current {@code Flowable} to honor backpressure as well. @@ -14239,7 +14239,7 @@ public final Flowable retry(@NonNull BiPredicate<@NonNull ? super Integer, @N * Returns a {@code Flowable} that mirrors the current {@code Flowable}, resubscribing to it if it calls {@code onError} * up to a specified number of retries. *

- * + * *

* If the current {@code Flowable} calls {@link Subscriber#onError}, this method will resubscribe to the current * {@code Flowable} for a maximum of {@code count} resubscriptions rather than propagating the @@ -14352,7 +14352,7 @@ public final Flowable retryUntil(@NonNull BooleanSupplier stop) { * {@code onComplete} or {@code onError} on the child subscription. Otherwise, this {@code Publisher} will * resubscribe to the current {@code Flowable}. *

- * + * *

* Example: * @@ -14462,7 +14462,7 @@ public final void safeSubscribe(@NonNull Subscriber<@NonNull ? super T> subscrib * Returns a {@code Flowable} that emits the most recently emitted item (if any) emitted by the current {@code Flowable} * within periodic time intervals. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -14528,7 +14528,7 @@ public final Flowable sample(long period, @NonNull TimeUnit unit, boolean emi * Returns a {@code Flowable} that emits the most recently emitted item (if any) emitted by the current {@code Flowable} * within periodic time intervals, where the intervals are defined on a particular {@link Scheduler}. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -14674,7 +14674,7 @@ public final Flowable sample(@NonNull Publisher sampler, boolean emitL * {@code Floawble} into the same function, and so on until all items have been emitted by the current {@code Flowable}, * emitting the result of each of these iterations. *

- * + * *

* This sort of function is sometimes called an accumulator. *

@@ -14708,7 +14708,7 @@ public final Flowable scan(@NonNull BiFunction accumulator) { * the current {@code Flowable} into the same function, and so on until all items have been emitted by the current * {@code Flowable}, emitting the result of each of these iterations. *

- * + * *

* This sort of function is sometimes called an accumulator. *

@@ -14762,7 +14762,7 @@ public final Flowable scan(@NonNull BiFunction accumulator) { * the current {@code Flowable} into the same function, and so on until all items have been emitted by the current * {@code Flowable}, emitting the result of each of these iterations. *

- * + * *

* This sort of function is sometimes called an accumulator. *

@@ -14807,7 +14807,7 @@ public final Flowable scan(@NonNull BiFunction accumulator) { * {@code onNext} from two different threads concurrently. You can force such a {@code Publisher} to be * well-behaved and sequential by applying the {@code serialize} method to it. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -14834,7 +14834,7 @@ public final Flowable serialize() { *

* This is an alias for {@link #publish()}.{@link ConnectableFlowable#refCount() refCount()}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure and expects the current {@code Flowable} to honor backpressure as well. @@ -14860,7 +14860,7 @@ public final Flowable share() { * signals exactly one item or signals an {@link IllegalArgumentException} if this {@code Flowable} signals * more than one item. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -14885,7 +14885,7 @@ public final Maybe singleElement() { * emits only a single item, or a default item if the current {@code Flowable} emits no items. If the current * {@code Flowable} emits more than one item, an {@link IllegalArgumentException} is signaled instead. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -14939,7 +14939,7 @@ public final Single singleOrError() { * Returns a {@code Flowable} that skips the first {@code count} items emitted by the current {@code Flowable} and emits * the remainder. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -14972,7 +14972,7 @@ public final Flowable skip(long count) { * Returns a {@code Flowable} that skips values emitted by the current {@code Flowable} before a specified time window * elapses. *

- * + * *

*
Backpressure:
*
The operator doesn't support backpressure as it uses time to skip an arbitrary number of elements and @@ -15002,7 +15002,7 @@ public final Flowable skip(long time, @NonNull TimeUnit unit) { * Returns a {@code Flowable} that skips values emitted by the current {@code Flowable} before a specified time window * on a specified {@link Scheduler} elapses. *

- * + * *

*
Backpressure:
*
The operator doesn't support backpressure as it uses time to skip an arbitrary number of elements and @@ -15033,7 +15033,7 @@ public final Flowable skip(long time, @NonNull TimeUnit unit, @NonNull Schedu * Returns a {@code Flowable} that drops a specified number of items from the end of the sequence emitted by the * current {@code Flowable}. *

- * + * *

* This {@link Subscriber} accumulates a queue long enough to store the first {@code count} items. As more items are * received, items are taken from the front of the queue and emitted by the resulting {@code Flowable}. This causes @@ -15071,7 +15071,7 @@ public final Flowable skipLast(int count) { * Returns a {@code Flowable} that drops items emitted by the current {@code Flowable} during a specified time window * before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -15103,7 +15103,7 @@ public final Flowable skipLast(long time, @NonNull TimeUnit unit) { * Returns a {@code Flowable} that drops items emitted by the current {@code Flowable} during a specified time window * before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -15138,7 +15138,7 @@ public final Flowable skipLast(long time, @NonNull TimeUnit unit, boolean del * Returns a {@code Flowable} that drops items emitted by the current {@code Flowable} during a specified time window * (defined on a specified scheduler) before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -15171,7 +15171,7 @@ public final Flowable skipLast(long time, @NonNull TimeUnit unit, @NonNull Sc * Returns a {@code Flowable} that drops items emitted by the current {@code Flowable} during a specified time window * (defined on a specified scheduler) before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -15207,7 +15207,7 @@ public final Flowable skipLast(long time, @NonNull TimeUnit unit, @NonNull Sc * Returns a {@code Flowable} that drops items emitted by the current {@code Flowable} during a specified time window * (defined on a specified scheduler) before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -15251,7 +15251,7 @@ public final Flowable skipLast(long time, @NonNull TimeUnit unit, @NonNull Sc * Returns a {@code Flowable} that skips items emitted by the current {@code Flowable} until a second {@link Publisher} emits * an item. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -15281,7 +15281,7 @@ public final Flowable skipUntil(@NonNull Publisher other) { * Returns a {@code Flowable} that skips all items emitted by the current {@code Flowable} as long as a specified * condition holds {@code true}, but emits all further source items as soon as the condition becomes {@code false}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -15367,7 +15367,7 @@ public final Flowable sorted(@NonNull Comparator<@NonNull ? super T> comparat * Returns a {@code Flowable} that emits the items in a specified {@link Iterable} before it begins to emit items * emitted by the current {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The Current {@code Flowable} @@ -15473,7 +15473,7 @@ public final Flowable startWith(@NonNull MaybeSource other) { * Returns a {@code Flowable} that emits the items in a specified {@link Publisher} before it begins to emit * items emitted by the current {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. Both this and the {@code other} {@code Publisher}s @@ -15502,7 +15502,7 @@ public final Flowable startWith(@NonNull Publisher<@NonNull ? extends T> othe * Returns a {@code Flowable} that emits a specified item before it begins to emit items emitted by the current * {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The current {@code Flowable} @@ -15534,7 +15534,7 @@ public final Flowable startWithItem(@NonNull T item) { * Returns a {@code Flowable} that emits the specified items before it begins to emit items emitted by the current * {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The current {@code Flowable} @@ -15815,7 +15815,7 @@ public final void subscribe(@NonNull FlowableSubscriber<@NonNull ? super T> subs * chain, it is recommended to use {@code subscribeOn(scheduler, false)} instead * to avoid same-pool deadlock because requests may pile up behind an eager/blocking emitter. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -15850,7 +15850,7 @@ public final Flowable subscribeOn(@NonNull Scheduler scheduler) { * chain, it is recommended to have {@code requestOn} {@code false} to avoid same-pool deadlock * because requests may pile up behind an eager/blocking emitter. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -15919,7 +15919,7 @@ public final Flowable switchIfEmpty(@NonNull Publisher<@NonNull ? extends T> * The resulting {@code Flowable} completes if both the current {@code Flowable} and the last inner {@code Publisher}, if any, complete. * If the current {@code Flowable} signals an {@code onError}, the inner {@code Publisher} is canceled and the error delivered in-sequence. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The outer {@code Publisher} is consumed in an @@ -15955,7 +15955,7 @@ public final Flowable switchMap(@NonNull Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The outer {@code Publisher} is consumed in an @@ -16090,7 +16090,7 @@ public final Completable switchMapCompletableDelayError(@NonNull Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The outer {@code Publisher} is consumed in an @@ -16128,7 +16128,7 @@ public final Flowable switchMapDelayError(@NonNull Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The outer {@code Publisher} is consumed in an @@ -16180,7 +16180,7 @@ Flowable switchMap0(Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The main {@code Flowable} is consumed in an @@ -16221,7 +16221,7 @@ public final Flowable switchMapMaybe(@NonNull Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The main {@code Flowable} is consumed in an @@ -16254,7 +16254,7 @@ public final Flowable switchMapMaybeDelayError(@NonNull Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The main {@code Flowable} is consumed in an @@ -16295,7 +16295,7 @@ public final Flowable switchMapSingle(@NonNull Function - * + * *
*
Backpressure:
*
The operator honors backpressure from downstream. The main {@code Flowable} is consumed in an @@ -16326,7 +16326,7 @@ public final Flowable switchMapSingleDelayError(@NonNull Function - * + * *

* This method returns a {@code Flowable} that will invoke a subscribing {@link Subscriber}'s * {@link Subscriber#onNext onNext} function a maximum of {@code count} times before invoking @@ -16380,7 +16380,7 @@ public final Flowable take(long count) { * If time runs out before the {@code Flowable} completes normally, the {@code onComplete} event will be * signaled on the default {@code computation} {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -16412,7 +16412,7 @@ public final Flowable take(long time, @NonNull TimeUnit unit) { * If time runs out before the {@code Flowable} completes normally, the {@code onComplete} event will be * signaled on the provided {@code Scheduler}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -16443,7 +16443,7 @@ public final Flowable take(long time, @NonNull TimeUnit unit, @NonNull Schedu * Returns a {@code Flowable} that emits at most the last {@code count} items emitted by the current {@code Flowable}. If the source emits fewer than * {@code count} items then all of its items are emitted. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream if the {@code count} is non-zero; ignores @@ -16481,7 +16481,7 @@ public final Flowable takeLast(int count) { * Returns a {@code Flowable} that emits at most a specified number of items from the current {@code Flowable} that were * emitted in a specified window of time before the current {@code Flowable} completed. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16515,7 +16515,7 @@ public final Flowable takeLast(long count, long time, @NonNull TimeUnit unit) * emitted in a specified window of time before the current {@code Flowable} completed, where the timing information is * provided by a given {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16551,7 +16551,7 @@ public final Flowable takeLast(long count, long time, @NonNull TimeUnit unit, * emitted in a specified window of time before the current {@code Flowable} completed, where the timing information is * provided by a given {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16597,7 +16597,7 @@ public final Flowable takeLast(long count, long time, @NonNull TimeUnit unit, * Returns a {@code Flowable} that emits the items from the current {@code Flowable} that were emitted in a specified * window of time before the current {@code Flowable} completed. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16628,7 +16628,7 @@ public final Flowable takeLast(long time, @NonNull TimeUnit unit) { * Returns a {@code Flowable} that emits the items from the current {@code Flowable} that were emitted in a specified * window of time before the current {@code Flowable} completed. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16663,7 +16663,7 @@ public final Flowable takeLast(long time, @NonNull TimeUnit unit, boolean del * window of time before the current {@code Flowable} completed, where the timing information is provided by a specified * {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16697,7 +16697,7 @@ public final Flowable takeLast(long time, @NonNull TimeUnit unit, @NonNull Sc * window of time before the current {@code Flowable} completed, where the timing information is provided by a specified * {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16734,7 +16734,7 @@ public final Flowable takeLast(long time, @NonNull TimeUnit unit, @NonNull Sc * window of time before the current {@code Flowable} completed, where the timing information is provided by a specified * {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream and consumes the current {@code Flowable} in an @@ -16773,7 +16773,7 @@ public final Flowable takeLast(long time, @NonNull TimeUnit unit, @NonNull Sc * Returns a {@code Flowable} that emits items emitted by the current {@code Flowable}, checks the specified predicate * for each item, and then completes when the condition is satisfied. *

- * + * *

* The difference between this operator and {@link #takeWhile(Predicate)} is that here, the condition is * evaluated after the item is emitted. @@ -16807,7 +16807,7 @@ public final Flowable takeUntil(@NonNull Predicate stopPredicate) * Returns a {@code Flowable} that emits the items emitted by the current {@code Flowable} until a second {@link Publisher} * emits an item. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -16838,7 +16838,7 @@ public final Flowable takeUntil(@NonNull Publisher other) { * Returns a {@code Flowable} that emits items emitted by the current {@code Flowable} so long as each item satisfied a * specified condition, and then completes as soon as this condition is not satisfied. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -16870,7 +16870,7 @@ public final Flowable takeWhile(@NonNull Predicate predicate) { * This differs from {@link #throttleLast} in that this only tracks the passage of time whereas * {@link #throttleLast} ticks at scheduled intervals. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -16902,7 +16902,7 @@ public final Flowable throttleFirst(long windowDuration, @NonNull TimeUnit un * This differs from {@link #throttleLast} in that this only tracks the passage of time whereas * {@link #throttleLast} ticks at scheduled intervals. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -16939,7 +16939,7 @@ public final Flowable throttleFirst(long skipDuration, @NonNull TimeUnit unit * This differs from {@link #throttleFirst} in that this ticks along at a scheduled interval whereas * {@link #throttleFirst} does not tick, it just tracks the passage of time. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -16973,7 +16973,7 @@ public final Flowable throttleLast(long intervalDuration, @NonNull TimeUnit u * This differs from {@link #throttleFirst(long, TimeUnit, Scheduler)} in that this ticks along at a scheduled interval whereas * {@code throttleFirst} does not tick, it just tracks the passage of time. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -17171,7 +17171,7 @@ public final Flowable throttleLatest(long timeout, @NonNull TimeUnit unit, @N * Note: If items keep being emitted by the current {@code Flowable} faster than the timeout then no items * will be emitted by the resulting {@code Flowable}. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -17207,7 +17207,7 @@ public final Flowable throttleWithTimeout(long timeout, @NonNull TimeUnit uni * Note: If items keep being emitted by the current {@code Flowable} faster than the timeout then no items * will be emitted by the resulting {@code Flowable}. *

- * + * *

*
Backpressure:
*
This operator does not support backpressure as it uses time to control data flow.
@@ -17242,7 +17242,7 @@ public final Flowable throttleWithTimeout(long timeout, @NonNull TimeUnit uni * Returns a {@code Flowable} that emits records of the time interval between consecutive items emitted by the * current {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17267,7 +17267,7 @@ public final Flowable> timeInterval() { * Returns a {@code Flowable} that emits records of the time interval between consecutive items emitted by the * current {@code Flowable}, where this interval is computed on a specified {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17295,7 +17295,7 @@ public final Flowable> timeInterval(@NonNull Scheduler scheduler) { * Returns a {@code Flowable} that emits records of the time interval between consecutive items emitted by the * current {@code Flowable}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17322,7 +17322,7 @@ public final Flowable> timeInterval(@NonNull TimeUnit unit) { * Returns a {@code Flowable} that emits records of the time interval between consecutive items emitted by the * current {@code Flowable}, where this interval is computed on a specified {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17355,7 +17355,7 @@ public final Flowable> timeInterval(@NonNull TimeUnit unit, @NonNull Sc * time after the emission of the previous item, where that period of time is measured by a {@link Publisher} that * is a function of the previous item. *

- * + * *

* Note: The arrival of the first source item is never timed out. *

@@ -17391,7 +17391,7 @@ public final Flowable timeout(@NonNull Function - * + * *

* Note: The arrival of the first source item is never timed out. *

@@ -17429,7 +17429,7 @@ public final Flowable timeout(@NonNull Function - * + * *
*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17459,7 +17459,7 @@ public final Flowable timeout(long timeout, @NonNull TimeUnit unit) { * item. If the next item isn't emitted within the specified timeout duration starting from its predecessor, * the current {@code Flowable} is disposed and the resulting {@code Flowable} begins instead to mirror a fallback {@link Publisher}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The {@code Publisher} @@ -17495,7 +17495,7 @@ public final Flowable timeout(long timeout, @NonNull TimeUnit unit, @NonNull * starting from its predecessor, the current {@code Flowable} is disposed and the resulting {@code Flowable} begins * instead to mirror a fallback {@link Publisher}. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The {@code Publisher} @@ -17533,7 +17533,7 @@ public final Flowable timeout(long timeout, @NonNull TimeUnit unit, @NonNull * specified timeout duration starting from its predecessor, the resulting {@code Flowable} terminates and * notifies {@link Subscriber}s of a {@link TimeoutException}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17565,7 +17565,7 @@ public final Flowable timeout(long timeout, @NonNull TimeUnit unit, @NonNull * {@link TimeoutException} if either the first item emitted by the current {@code Flowable} or any subsequent item * doesn't arrive within time windows defined by other {@link Publisher}s. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. Both this and the returned {@code Publisher}s @@ -17605,7 +17605,7 @@ public final Flowable timeout(@NonNull Publisher firstTimeoutIndica * the first item emitted by the current {@code Flowable} or any subsequent item doesn't arrive within time windows * defined by other {@code Publisher}s. *

- * + * *

*
Backpressure:
*
The operator honors backpressure from downstream. The {@code Publisher} @@ -17665,7 +17665,7 @@ private Flowable timeout0( * Returns a {@code Flowable} that emits each item emitted by the current {@code Flowable}, wrapped in a * {@link Timed} object. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17690,7 +17690,7 @@ public final Flowable> timestamp() { * Returns a {@code Flowable} that emits each item emitted by the current {@code Flowable}, wrapped in a * {@link Timed} object whose timestamps are provided by a specified {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17718,7 +17718,7 @@ public final Flowable> timestamp(@NonNull Scheduler scheduler) { * Returns a {@code Flowable} that emits each item emitted by the current {@code Flowable}, wrapped in a * {@link Timed} object. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17745,7 +17745,7 @@ public final Flowable> timestamp(@NonNull TimeUnit unit) { * Returns a {@code Flowable} that emits each item emitted by the current {@code Flowable}, wrapped in a * {@link Timed} object whose timestamps are provided by a specified {@link Scheduler}. *

- * + * *

*
Backpressure:
*
The operator doesn't interfere with backpressure which is determined by the current {@code Flowable}'s backpressure @@ -17800,7 +17800,7 @@ public final R to(@NonNull FlowableConverter converter) { * Returns a {@link Single} that emits a single item, a list composed of all the items emitted by the * finite upstream source {@link Publisher}. *

- * + * *

* Normally, a {@code Publisher} that returns multiple items will do so by invoking its {@link Subscriber}'s * {@link Subscriber#onNext onNext} method for each such item. You can change this behavior by having the @@ -17834,7 +17834,7 @@ public final Single> toList() { * Returns a {@link Single} that emits a single item, a list composed of all the items emitted by the * finite source {@link Publisher}. *

- * + * *

* Normally, a {@code Publisher} that returns multiple items will do so by invoking its {@link Subscriber}'s * {@link Subscriber#onNext onNext} method for each such item. You can change this behavior by having the @@ -17872,7 +17872,7 @@ public final Single> toList(int capacityHint) { * Returns a {@link Single} that emits a single item, a list composed of all the items emitted by the * finite source {@link Publisher}. *

- * + * *

* Normally, a {@code Publisher} that returns multiple items will do so by invoking its {@link Subscriber}'s * {@link Subscriber#onNext onNext} method for each such item. You can change this behavior by having the @@ -17911,7 +17911,7 @@ public final > Single toList(@NonNull Supplie * Returns a {@link Single} that emits a single {@link HashMap} containing all items emitted by the finite source {@link Publisher}, * mapped by the keys returned by a specified {@code keySelector} function. *

- * + * *

* If more than one source item maps to the same key, the {@code HashMap} will contain the latest of those items. *

@@ -17946,7 +17946,7 @@ public final Single> toMap(@NonNull Function - * + * *

* If more than one source item maps to the same key, the {@code HashMap} will contain a single entry that * corresponds to the latest of those items. @@ -17986,7 +17986,7 @@ public final Single> toMap(@NonNull Function - * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated map to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18027,7 +18027,7 @@ public final Single> toMap(@NonNull Function - * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated map to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18062,7 +18062,7 @@ public final Single>> toMultimap(@NonNull Function - * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated map to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18100,7 +18100,7 @@ public final Single>> toMultimap(@NonNull Function - * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated map to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18148,7 +18148,7 @@ public final Single>> toMultimap( * contains an {@link ArrayList} of values, extracted by a specified {@code valueSelector} function from items * emitted by the finite source {@link Publisher} and keyed by the {@code keySelector} function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated map to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18214,7 +18214,7 @@ public final Observable toObservable() { * all other items emitted by this {@code Flowable}, no items will be emitted and the * sequence is terminated with a {@link ClassCastException}. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated list to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18241,7 +18241,7 @@ public final Single> toSortedList() { * Returns a {@link Single} that emits a {@link List} that contains the items emitted by the finite source {@link Publisher}, in a * sorted order based on a specified comparison function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated list to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18274,7 +18274,7 @@ public final Single> toSortedList(@NonNull Comparator compara * Returns a {@link Single} that emits a {@link List} that contains the items emitted by the finite source {@link Publisher}, in a * sorted order based on a specified comparison function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated list to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18316,7 +18316,7 @@ public final Single> toSortedList(@NonNull Comparator compara * all other items emitted by this {@code Flowable}, no items will be emitted and the * sequence is terminated with a {@link ClassCastException}. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated list to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -18380,7 +18380,7 @@ public final Flowable unsubscribeOn(@NonNull Scheduler scheduler) { * {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the current window and * propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window will only contain one element. The behavior is @@ -18413,7 +18413,7 @@ public final Flowable> window(long count) { * the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the current window * and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18450,7 +18450,7 @@ public final Flowable> window(long count, long skip) { * the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the current window * and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18493,7 +18493,7 @@ public final Flowable> window(long count, long skip, int bufferSize) * {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the * current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18535,7 +18535,7 @@ public final Flowable> window(long timespan, long timeskip, @NonNull * {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the * current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18579,7 +18579,7 @@ public final Flowable> window(long timespan, long timeskip, @NonNull * {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the * current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18630,7 +18630,7 @@ public final Flowable> window(long timespan, long timeskip, @NonNull * {@code timespan} argument. When the current {@code Flowable} completes or encounters an error, the resulting * {@code Flowable} emits the current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18670,7 +18670,7 @@ public final Flowable> window(long timespan, @NonNull TimeUnit unit) * reached first). When the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} * emits the current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18714,7 +18714,7 @@ public final Flowable> window(long timespan, @NonNull TimeUnit unit, * reached first). When the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} * emits the current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18759,7 +18759,7 @@ public final Flowable> window(long timespan, @NonNull TimeUnit unit, * {@code timespan} argument. When the current {@code Flowable} completes or encounters an error, the resulting * {@code Flowable} emits the current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18803,7 +18803,7 @@ public final Flowable> window(long timespan, @NonNull TimeUnit unit, * first). When the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the * current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18849,7 +18849,7 @@ public final Flowable> window(long timespan, @NonNull TimeUnit unit, * first). When the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the * current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18897,7 +18897,7 @@ public final Flowable> window(long timespan, @NonNull TimeUnit unit, * first). When the current {@code Flowable} completes or encounters an error, the resulting {@code Flowable} emits the * current window and propagates the notification from the current {@code Flowable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18950,7 +18950,7 @@ public final Flowable> window( * where the boundary of each window is determined by the items emitted from a specified boundary-governing * {@link Publisher}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -18985,7 +18985,7 @@ public final Flowable> window(@NonNull Publisher boundaryIndi * where the boundary of each window is determined by the items emitted from a specified boundary-governing * {@link Publisher}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -19026,7 +19026,7 @@ public final Flowable> window(@NonNull Publisher boundaryIndi * the {@code windowOpenings} {@link Publisher} emits an item and when the {@code Publisher} returned by * {@code closingSelector} emits an item. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -19069,7 +19069,7 @@ public final Flowable> window( * the {@code windowOpenings} {@link Publisher} emits an item and when the {@code Publisher} returned by * {@code closingSelector} emits an item. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -19116,7 +19116,7 @@ public final Flowable> window( * Merges the specified {@link Publisher} into the current {@code Flowable} sequence by using the {@code resultSelector} * function only when the current {@code Flowable} (this instance) emits an item. *

- * + * * *

*
Backpressure:
@@ -19357,7 +19357,7 @@ public final Flowable withLatestFrom(@NonNull Iterable<@NonNull ? extends * Returns a {@code Flowable} that emits items that are the result of applying a specified function to pairs of * values, one each from the current {@code Flowable} and a specified {@link Iterable} sequence. *

- * + * *

* Note that the {@code other} {@code Iterable} is evaluated as items are observed from the current {@code Flowable}; it is * not pre-consumed. This allows you to zip infinite streams on either side. @@ -19409,7 +19409,7 @@ public final Flowable withLatestFrom(@NonNull Iterable<@NonNull ? extends * use {@link #doOnCancel(Action)} as well or use {@code using()} to do cleanup in case of completion * or cancellation. *

- * + * *

*
Backpressure:
*
The operator expects backpressure from the sources and honors backpressure from the downstream. @@ -19457,7 +19457,7 @@ public final Flowable zipWith(@NonNull Publisher<@NonNull ? extends U> * use {@link #doOnCancel(Action)} as well or use {@code using()} to do cleanup in case of completion * or cancellation. *

- * + * *

*
Backpressure:
*
The operator expects backpressure from the sources and honors backpressure from the downstream. @@ -19508,7 +19508,7 @@ public final Flowable zipWith(@NonNull Publisher<@NonNull ? extends U> * use {@link #doOnCancel(Action)} as well or use {@code using()} to do cleanup in case of completion * or cancellation. *

- * + * *

*
Backpressure:
*
The operator expects backpressure from the sources and honors backpressure from the downstream. diff --git a/src/main/java/io/reactivex/rxjava3/core/Maybe.java b/src/main/java/io/reactivex/rxjava3/core/Maybe.java index dba5a15219..f5ff68247a 100644 --- a/src/main/java/io/reactivex/rxjava3/core/Maybe.java +++ b/src/main/java/io/reactivex/rxjava3/core/Maybe.java @@ -898,7 +898,7 @@ public static Maybe defer(@NonNull Supplier - * + * *
*
Scheduler:
*
{@code empty} does not operate by default on a particular {@link Scheduler}.
@@ -1239,7 +1239,7 @@ public static Maybe fromRunnable(@NonNull Runnable run) { * subscribes to the returned {@code Maybe}. In other terms, this source operator evaluates the given * {@code Supplier} "lazily". *

- * + * *

* Note that the {@code null} handling of this operator differs from the similar source operators in the other * {@link io.reactivex.rxjava3.core base reactive classes}. Those operators signal a {@link NullPointerException} if the value returned by their @@ -1946,7 +1946,7 @@ public static Flowable mergeDelayError( /** * Returns a {@code Maybe} that never sends any items or notifications to a {@link MaybeObserver}. *

- * + * *

* This {@code Maybe} is useful primarily for testing purposes. *

@@ -3628,7 +3628,7 @@ public final Maybe doOnDispose(@NonNull Action onDispose) { /** * Invokes an {@link Action} just before the current {@code Maybe} calls {@code onComplete}. *

- * + * *

*
Scheduler:
*
{@code doOnComplete} does not operate by default on a particular {@link Scheduler}.
@@ -3658,7 +3658,7 @@ public final Maybe doOnComplete(@NonNull Action onComplete) { * Calls the shared {@link Consumer} with the error sent via {@code onError} for each * {@link MaybeObserver} that subscribes to the current {@code Maybe}. *

- * + * *

*
Scheduler:
*
{@code doOnError} does not operate by default on a particular {@link Scheduler}.
@@ -3793,7 +3793,7 @@ public final Maybe doOnTerminate(@NonNull Action onTerminate) { * Calls the shared {@link Consumer} with the success value sent via {@code onSuccess} for each * {@link MaybeObserver} that subscribes to the current {@code Maybe}. *

- * + * *

*
Scheduler:
*
{@code doOnSuccess} does not operate by default on a particular {@link Scheduler}.
@@ -4345,7 +4345,7 @@ public final Maybe map(@NonNull Function mapper) * Maps the signal types of this {@code Maybe} into a {@link Notification} of the same kind * and emits it as a {@link Single}'s {@code onSuccess} value to downstream. *

- * + * *

*
Scheduler:
*
{@code materialize} does not operate by default on a particular {@link Scheduler}.
diff --git a/src/main/java/io/reactivex/rxjava3/core/Observable.java b/src/main/java/io/reactivex/rxjava3/core/Observable.java index 9972112585..2e0aff91ba 100644 --- a/src/main/java/io/reactivex/rxjava3/core/Observable.java +++ b/src/main/java/io/reactivex/rxjava3/core/Observable.java @@ -52,7 +52,7 @@ *

* The documentation for this class makes use of marble diagrams. The following legend explains these diagrams: *

- * + * *

* The design of this class was derived from the * Reactive-Streams design and specification @@ -105,7 +105,7 @@ public abstract class Observable<@NonNull T> implements ObservableSource { * Mirrors the one {@link ObservableSource} in an {@link Iterable} of several {@code ObservableSource}s that first either emits an item or sends * a termination notification. *

- * + * *

*
Scheduler:
*
{@code amb} does not operate by default on a particular {@link Scheduler}.
@@ -131,7 +131,7 @@ public static Observable amb(@NonNull Iterable<@NonNull ? extends Observa * Mirrors the one {@link ObservableSource} in an array of several {@code ObservableSource}s that first either emits an item or sends * a termination notification. *

- * + * *

*
Scheduler:
*
{@code ambArray} does not operate by default on a particular {@link Scheduler}.
@@ -191,7 +191,7 @@ public static int bufferSize() { * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -235,7 +235,7 @@ public static Observable combineLatest( * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -288,7 +288,7 @@ public static Observable combineLatest( * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatestArray} does not operate by default on a particular {@link Scheduler}.
@@ -332,7 +332,7 @@ public static Observable combineLatestArray( * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatestArray} does not operate by default on a particular {@link Scheduler}.
@@ -380,7 +380,7 @@ public static Observable combineLatestArray( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -421,7 +421,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -467,7 +467,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -518,7 +518,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -574,7 +574,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -634,7 +634,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -700,7 +700,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -770,7 +770,7 @@ public static Observable combineLatest( * resulting sequence terminates immediately (normally or with all the errors accumulated till that point). * If that input source is also synchronous, other sources after it will not be subscribed to. *

- * + * *

*
Scheduler:
*
{@code combineLatest} does not operate by default on a particular {@link Scheduler}.
@@ -841,7 +841,7 @@ public static Observable combineLates * the {@code ObservableSource}s each time an item is received from any of the {@code ObservableSource}s, where this * aggregation is defined by a specified function. *

- * + * *

* Note on method signature: since Java doesn't allow creating a generic array with {@code new T[]}, the * implementation of this operator has to create an {@code Object[]} instead. Unfortunately, a @@ -898,7 +898,7 @@ public static Observable combineLatestArrayDelayError( * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatestArrayDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -953,7 +953,7 @@ public static Observable combineLatestArrayDelayError(@NonNull Observa * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatestDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -997,7 +997,7 @@ public static Observable combineLatestDelayError(@NonNull Iterable<@No * any items and without any calls to the combiner function. * *

- * + * *

*
Scheduler:
*
{@code combineLatestDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -1036,7 +1036,7 @@ public static Observable combineLatestDelayError(@NonNull Iterable<@No * Concatenates elements of each {@link ObservableSource} provided via an {@link Iterable} sequence into a single sequence * of elements without interleaving them. *

- * + * *

*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -1059,7 +1059,7 @@ public static Observable concat(@NonNull Iterable<@NonNull ? extends Obse * Returns an {@code Observable} that emits the items emitted by each of the {@link ObservableSource}s emitted by the * {@code ObservableSource}, one after the other, without interleaving them. *

- * + * *

*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -1083,7 +1083,7 @@ public static Observable concat(@NonNull ObservableSource - * + * *
*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -1113,7 +1113,7 @@ public static Observable concat(@NonNull ObservableSource - * + * *
*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -1141,7 +1141,7 @@ public static Observable concat(@NonNull ObservableSource so * Returns an {@code Observable} that emits the items emitted by three {@link ObservableSource}s, one after the other, without * interleaving them. *

- * + * *

*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -1174,7 +1174,7 @@ public static Observable concat( * Returns an {@code Observable} that emits the items emitted by four {@link ObservableSource}s, one after the other, without * interleaving them. *

- * + * *

*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -1211,7 +1211,7 @@ public static Observable concat( *

* Note: named this way because of overload conflict with {@code concat(ObservableSource)} *

- * + * *

*
Scheduler:
*
{@code concatArray} does not operate by default on a particular {@link Scheduler}.
@@ -1241,7 +1241,7 @@ public static Observable concatArray(@NonNull ObservableSource - * + * *
*
Scheduler:
*
{@code concatArrayDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -1389,7 +1389,7 @@ public static Observable concatArrayEagerDelayError(int maxConcurrency, i * by subscribing to each {@code ObservableSource}, one after the other, one at a time and delays any errors till * the all inner {@code ObservableSource}s terminate. *

- * + * *

*
Scheduler:
*
{@code concatDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -1413,7 +1413,7 @@ public static Observable concatDelayError(@NonNull Iterable<@NonNull ? ex * by subscribing to each inner {@code ObservableSource}, one after the other, one at a time and delays any errors till the * all inner and the outer {@code ObservableSource}s terminate. *

- * + * *

*
Scheduler:
*
{@code concatDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -1435,7 +1435,7 @@ public static Observable concatDelayError(@NonNull ObservableSource - * + * *
*
Scheduler:
*
{@code concatDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -1722,7 +1722,7 @@ public static Observable concatEagerDelayError(@NonNull ObservableSource< * disposes the flow (making {@link ObservableEmitter#isDisposed} return {@code true}), * other observers subscribed to the same returned {@code Observable} are not affected. *

- * + * *

* You should call the {@code ObservableEmitter}'s {@code onNext}, {@code onError} and {@code onComplete} methods in a serialized fashion. The * rest of its methods are thread-safe. @@ -1752,7 +1752,7 @@ public static Observable create(@NonNull ObservableOnSubscribe source) * that subscribes. That is, for each subscriber, the actual {@code ObservableSource} that subscriber observes is * determined by the factory function. *

- * + * *

* The {@code defer} operator allows you to defer or delay emitting items from an {@code ObservableSource} until such time as an * {@code Observer} subscribes to the {@code ObservableSource}. This allows an {@code Observer} to easily obtain updates or a @@ -1783,7 +1783,7 @@ public static Observable defer(@NonNull Supplier - * + * *

*
Scheduler:
*
{@code empty} does not operate by default on a particular {@link Scheduler}.
@@ -1887,7 +1887,7 @@ public static Observable fromAction(@NonNull Action action) { /** * Converts an array into an {@link ObservableSource} that emits the items in the array. *

- * + * *

*
Scheduler:
*
{@code fromArray} does not operate by default on a particular {@link Scheduler}.
@@ -1920,7 +1920,7 @@ public static Observable fromArray(@NonNull T... items) { * Returns an {@code Observable} that, when an observer subscribes to it, invokes a function you specify and then * emits the value returned from that function. *

- * + * *

* This allows you to defer the execution of the function you specify until an observer subscribes to the * {@code Observable}. That is to say, it makes the function "lazy." @@ -2059,7 +2059,7 @@ public static Observable fromFuture(@NonNull Future future, /** * Converts an {@link Iterable} sequence into an {@code Observable} that emits the items in the sequence. *

- * + * *

*
Scheduler:
*
{@code fromIterable} does not operate by default on a particular {@link Scheduler}.
@@ -2201,7 +2201,7 @@ public static Observable fromSingle(@NonNull SingleSource source) { * Returns an {@code Observable} that, when an observer subscribes to it, invokes a supplier function you specify and then * emits the value returned from that function. *

- * + * *

* This allows you to defer the execution of the function you specify until an observer subscribes to the * {@code Observable}. That is to say, it makes the function "lazy." @@ -2238,7 +2238,7 @@ public static Observable fromSupplier(@NonNull Supplier supp /** * Returns a cold, synchronous and stateless generator of values. *

- * + * *

* Note that the {@link Emitter#onNext}, {@link Emitter#onError} and * {@link Emitter#onComplete} methods provided to the function via the {@link Emitter} instance should be called synchronously, @@ -2269,7 +2269,7 @@ public static Observable generate(@NonNull Consumer> generator /** * Returns a cold, synchronous and stateful generator of values. *

- * + * *

* Note that the {@link Emitter#onNext}, {@link Emitter#onError} and * {@link Emitter#onComplete} methods provided to the function via the {@link Emitter} instance should be called synchronously, @@ -2301,7 +2301,7 @@ public static Observable generate(@NonNull Supplier initialState, @ /** * Returns a cold, synchronous and stateful generator of values. *

- * + * *

* Note that the {@link Emitter#onNext}, {@link Emitter#onError} and * {@link Emitter#onComplete} methods provided to the function via the {@link Emitter} instance should be called synchronously, @@ -2338,7 +2338,7 @@ public static Observable generate( /** * Returns a cold, synchronous and stateful generator of values. *

- * + * *

* Note that the {@link Emitter#onNext}, {@link Emitter#onError} and * {@link Emitter#onComplete} methods provided to the function via the {@link Emitter} instance should be called synchronously, @@ -2370,7 +2370,7 @@ public static Observable generate(@NonNull Supplier initialState, @ /** * Returns a cold, synchronous and stateful generator of values. *

- * + * *

* Note that the {@link Emitter#onNext}, {@link Emitter#onError} and * {@link Emitter#onComplete} methods provided to the function via the {@link Emitter} instance should be called synchronously, @@ -2409,7 +2409,7 @@ public static Observable generate(@NonNull Supplier initialState, @ * Returns an {@code Observable} that emits a {@code 0L} after the {@code initialDelay} and ever increasing numbers * after each {@code period} of time thereafter. *

- * + * *

*
Scheduler:
*
{@code interval} operates by default on the {@code computation} {@link Scheduler}.
@@ -2437,7 +2437,7 @@ public static Observable interval(long initialDelay, long period, @NonNull * Returns an {@code Observable} that emits a {@code 0L} after the {@code initialDelay} and ever increasing numbers * after each {@code period} of time thereafter, on a specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -2469,7 +2469,7 @@ public static Observable interval(long initialDelay, long period, @NonNull /** * Returns an {@code Observable} that emits a sequential number every specified interval of time. *

- * + * *

*
Scheduler:
*
{@code interval} operates by default on the {@code computation} {@link Scheduler}.
@@ -2494,7 +2494,7 @@ public static Observable interval(long period, @NonNull TimeUnit unit) { * Returns an {@code Observable} that emits a sequential number every specified interval of time, on a * specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -2522,7 +2522,7 @@ public static Observable interval(long period, @NonNull TimeUnit unit, @No *

* The sequence completes immediately after the last value (start + count - 1) has been reached. *

- * + * *

*
Scheduler:
*
{@code intervalRange} by default operates on the {@link Schedulers#computation() computation} {@link Scheduler}.
@@ -2551,7 +2551,7 @@ public static Observable intervalRange(long start, long count, long initia *

* The sequence completes immediately after the last value (start + count - 1) has been reached. *

- * *

+ * *
*
Scheduler:
*
you provide the {@link Scheduler}.
*
@@ -2629,7 +2629,7 @@ public static Observable just(@NonNull T item) { /** * Converts two items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2658,7 +2658,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2) { /** * Converts three items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2690,7 +2690,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts four items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2725,7 +2725,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts five items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2764,7 +2764,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts six items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2806,7 +2806,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts seven items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2852,7 +2852,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts eight items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2901,7 +2901,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts nine items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -2953,7 +2953,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul /** * Converts ten items into an {@code Observable} that emits those items. *

- * + * *

*
Scheduler:
*
{@code just} does not operate by default on a particular {@link Scheduler}.
@@ -3010,7 +3010,7 @@ public static Observable just(@NonNull T item1, @NonNull T item2, @NonNul * Flattens an {@link Iterable} of {@link ObservableSource}s into one {@code Observable}, without any transformation, while limiting the * number of concurrent subscriptions to these {@code ObservableSource}s. *

- * + * *

* You can combine the items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3058,7 +3058,7 @@ public static Observable merge(@NonNull Iterable<@NonNull ? extends Obser * Flattens an array of {@link ObservableSource}s into one {@code Observable}, without any transformation, while limiting the * number of concurrent subscriptions to these {@code ObservableSource}s. *

- * + * *

* You can combine the items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3106,7 +3106,7 @@ public static Observable mergeArray(int maxConcurrency, int bufferSize, @ /** * Flattens an {@link Iterable} of {@link ObservableSource}s into one {@code Observable}, without any transformation. *

- * + * *

* You can combine the items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3148,7 +3148,7 @@ public static Observable merge(@NonNull Iterable<@NonNull ? extends Obser * Flattens an {@link Iterable} of {@link ObservableSource}s into one {@code Observable}, without any transformation, while limiting the * number of concurrent subscriptions to these {@code ObservableSource}s. *

- * + * *

* You can combine the items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3194,7 +3194,7 @@ public static Observable merge(@NonNull Iterable<@NonNull ? extends Obser * Flattens an {@link ObservableSource} that emits {@code ObservableSource}s into a single {@code Observable} that emits the items emitted by * those {@code ObservableSource}s, without any transformation. *

- * + * *

* You can combine the items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3238,7 +3238,7 @@ public static Observable merge(@NonNull ObservableSource - * + * *

* You can combine the items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3286,7 +3286,7 @@ public static Observable merge(@NonNull ObservableSource - * + * *

* You can combine items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3331,7 +3331,7 @@ public static Observable merge(@NonNull ObservableSource sou /** * Flattens three {@link ObservableSource}s into a single {@code Observable}, without any transformation. *

- * + * *

* You can combine items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3381,7 +3381,7 @@ public static Observable merge( /** * Flattens four {@link ObservableSource}s into a single {@code Observable}, without any transformation. *

- * + * *

* You can combine items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3434,7 +3434,7 @@ public static Observable merge( /** * Flattens an array of {@link ObservableSource}s into one {@code Observable}, without any transformation. *

- * + * *

* You can combine items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code merge} method. @@ -3482,7 +3482,7 @@ public static Observable mergeArray(@NonNull ObservableSource - * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3515,7 +3515,7 @@ public static Observable mergeDelayError(@NonNull Iterable<@NonNull ? ext * error via {@link Observer#onError onError}, {@code mergeDelayError} will refrain from propagating that * error notification until all of the merged {@code ObservableSource}s have finished emitting items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3553,7 +3553,7 @@ public static Observable mergeDelayError(@NonNull Iterable<@NonNull ? ext * error via {@link Observer#onError onError}, {@code mergeDelayError} will refrain from propagating that * error notification until all of the merged {@code ObservableSource}s have finished emitting items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3592,7 +3592,7 @@ public static Observable mergeArrayDelayError(int maxConcurrency, int buf * error via {@link Observer#onError onError}, {@code mergeDelayError} will refrain from propagating that * error notification until all of the merged {@code ObservableSource}s have finished emitting items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3628,7 +3628,7 @@ public static Observable mergeDelayError(@NonNull Iterable<@NonNull ? ext * error via {@link Observer#onError onError}, {@code mergeDelayError} will refrain from propagating that * error notification until all of the merged {@code ObservableSource}s have finished emitting items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3663,7 +3663,7 @@ public static Observable mergeDelayError(@NonNull ObservableSource - * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3702,7 +3702,7 @@ public static Observable mergeDelayError(@NonNull ObservableSource - * + * *

* Even if both merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3741,7 +3741,7 @@ public static Observable mergeDelayError( * from propagating that error notification until all of the merged {@code ObservableSource}s have finished emitting * items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3784,7 +3784,7 @@ public static Observable mergeDelayError( * will refrain from propagating that error notification until all of the merged {@code ObservableSource}s have finished * emitting items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3829,7 +3829,7 @@ public static Observable mergeDelayError( * error via {@link Observer#onError onError}, {@code mergeDelayError} will refrain from propagating that * error notification until all of the merged {@code ObservableSource}s have finished emitting items. *

- * + * *

* Even if multiple merged {@code ObservableSource}s send {@code onError} notifications, {@code mergeDelayError} will only * invoke the {@code onError} method of its {@code Observer}s once. @@ -3857,7 +3857,7 @@ public static Observable mergeArrayDelayError(@NonNull ObservableSource - * + * *

* The returned {@code Observable} is useful primarily for testing purposes. *

@@ -3881,7 +3881,7 @@ public static Observable never() { /** * Returns an {@code Observable} that emits a sequence of {@link Integer}s within a specified range. *

- * + * *

*
Scheduler:
*
{@code range} does not operate by default on a particular {@link Scheduler}.
@@ -3966,7 +3966,7 @@ public static Observable rangeLong(long start, long count) { * Returns a {@link Single} that emits a {@link Boolean} value that indicates whether two {@link ObservableSource} sequences are the * same by comparing the items emitted by each {@code ObservableSource} pairwise. *

- * + * *

*
Scheduler:
*
{@code sequenceEqual} does not operate by default on a particular {@link Scheduler}.
@@ -3994,7 +3994,7 @@ public static Single sequenceEqual(@NonNull ObservableSource - * + * *
*
Scheduler:
*
{@code sequenceEqual} does not operate by default on a particular {@link Scheduler}.
@@ -4026,7 +4026,7 @@ public static Single sequenceEqual( * same by comparing the items emitted by each {@code ObservableSource} pairwise based on the results of a specified * equality function. *

- * + * *

*
Scheduler:
*
{@code sequenceEqual} does not operate by default on a particular {@link Scheduler}.
@@ -4064,7 +4064,7 @@ public static Single sequenceEqual( * Returns a {@link Single} that emits a {@link Boolean} value that indicates whether two {@link ObservableSource} sequences are the * same by comparing the items emitted by each {@code ObservableSource} pairwise. *

- * + * *

*
Scheduler:
*
{@code sequenceEqual} does not operate by default on a particular {@link Scheduler}.
@@ -4095,7 +4095,7 @@ public static Single sequenceEqual(@NonNull ObservableSource - * + * *

* {@code switchOnNext} subscribes to an {@code ObservableSource} that emits {@code ObservableSource}s. Each time it observes one of * these emitted {@code ObservableSource}s, the {@code ObservableSource} returned by {@code switchOnNext} begins emitting the items @@ -4133,7 +4133,7 @@ public static Observable switchOnNext(@NonNull ObservableSource - * + * *

* {@code switchOnNext} subscribes to an {@code ObservableSource} that emits {@code ObservableSource}s. Each time it observes one of * these emitted {@code ObservableSource}s, the {@code ObservableSource} returned by {@code switchOnNext} begins emitting the items @@ -4165,7 +4165,7 @@ public static Observable switchOnNext(@NonNull ObservableSource - * + * *

* {@code switchOnNext} subscribes to an {@code ObservableSource} that emits {@code ObservableSource}s. Each time it observes one of * these emitted {@code ObservableSource}s, the {@code ObservableSource} returned by {@code switchOnNext} begins emitting the items @@ -4199,7 +4199,7 @@ public static Observable switchOnNextDelayError(@NonNull ObservableSource * Converts an {@link ObservableSource} that emits {@code ObservableSource}s into an {@code Observable} that emits the items emitted by the * most recently emitted of those {@code ObservableSource}s and delays any exception until all {@code ObservableSource}s terminate. *

- * + * *

* {@code switchOnNext} subscribes to an {@code ObservableSource} that emits {@code ObservableSource}s. Each time it observes one of * these emitted {@code ObservableSource}s, the {@code ObservableSource} returned by {@code switchOnNext} begins emitting the items @@ -4238,7 +4238,7 @@ public static Observable switchOnNextDelayError(@NonNull ObservableSource /** * Returns an {@code Observable} that emits {@code 0L} after a specified delay, and then completes. *

- * + * *

*
Scheduler:
*
{@code timer} operates by default on the {@code computation} {@link Scheduler}.
@@ -4263,7 +4263,7 @@ public static Observable timer(long delay, @NonNull TimeUnit unit) { * Returns an {@code Observable} that emits {@code 0L} after a specified delay, on a specified {@link Scheduler}, and then * completes. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -4322,7 +4322,7 @@ public static Observable unsafeCreate(@NonNull ObservableSource onSubs * that resource and calls the provided {@code resourceDisposer} function if this inner source terminates or the * downstream disposes the flow. *

- * + * *

*
Scheduler:
*
{@code using} does not operate by default on a particular {@link Scheduler}.
@@ -4355,7 +4355,7 @@ public static Observable using( * that resource and calls the provided {@code disposer} function if this inner source terminates or the * downstream disposes the flow; doing it before these end-states have been reached if {@code eager == true}, after otherwise. *

- * + * *

*
Scheduler:
*
{@code using} does not operate by default on a particular {@link Scheduler}.
@@ -4445,7 +4445,7 @@ public static Observable wrap(@NonNull ObservableSource source) { * {@code Function} passed to the method would trigger a {@link ClassCastException}. * *

- * + * *

*
Scheduler:
*
{@code zip} does not operate by default on a particular {@link Scheduler}.
@@ -4500,7 +4500,7 @@ public static Observable zip(@NonNull Iterable<@NonNull ? extends Obse * {@code Function} passed to the method would trigger a {@link ClassCastException}. * *

- * + * *

*
Scheduler:
*
{@code zip} does not operate by default on a particular {@link Scheduler}.
@@ -4539,7 +4539,7 @@ public static Observable zip(@NonNull Iterable<@NonNull ? extends Obse * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * two items emitted, in sequence, by two other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by {@code o1} and the first item @@ -4596,7 +4596,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * two items emitted, in sequence, by two other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by {@code o1} and the first item @@ -4654,7 +4654,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * two items emitted, in sequence, by two other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by {@code o1} and the first item @@ -4714,7 +4714,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * three items emitted, in sequence, by three other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by {@code o1}, the first item @@ -4777,7 +4777,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * four items emitted, in sequence, by four other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by {@code o1}, the first item @@ -4845,7 +4845,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * five items emitted, in sequence, by five other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by {@code o1}, the first item @@ -4917,7 +4917,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * six items emitted, in sequence, by six other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by each source {@code ObservableSource}, the @@ -4992,7 +4992,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * seven items emitted, in sequence, by seven other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by each source {@code ObservableSource}, the @@ -5073,7 +5073,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * eight items emitted, in sequence, by eight other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by each source {@code ObservableSource}, the @@ -5158,7 +5158,7 @@ public static Observable zip( * Returns an {@code Observable} that emits the results of a specified combiner function applied to combinations of * nine items emitted, in sequence, by nine other {@link ObservableSource}s. *

- * + * *

* {@code zip} applies this function in strict sequence, so the first item emitted by the resulting {@code Observable} * will be the result of the function applied to the first item emitted by each source {@code ObservableSource}, the @@ -5273,7 +5273,7 @@ public static Observable zip( * {@code Function} passed to the method would trigger a {@link ClassCastException}. * *

- * + * *

*
Scheduler:
*
{@code zipArray} does not operate by default on a particular {@link Scheduler}.
@@ -5344,7 +5344,7 @@ public final Single all(@NonNull Predicate predicate) { * Mirrors the current {@code Observable} or the other {@link ObservableSource} provided of which the first either emits an item or sends a termination * notification. *

- * + * *

*
Scheduler:
*
{@code ambWith} does not operate by default on a particular {@link Scheduler}.
@@ -5370,7 +5370,7 @@ public final Observable ambWith(@NonNull ObservableSource other) * specified condition, otherwise {@code false}. Note: this always emits {@code false} if the * current {@code Observable} is empty. *

- * + * *

* In Rx.Net this is the {@code any} {@link Observer} but we renamed it in RxJava to better match Java naming * idioms. @@ -5462,7 +5462,7 @@ public final T blockingFirst(@NonNull T defaultItem) { * {@link Consumer} with each upstream item on the current thread until the * upstream terminates. *

- * + * *

* Note: the method will only return if the upstream terminates or the current * thread is interrupted. @@ -5499,7 +5499,7 @@ public final void blockingForEach(@NonNull Consumer onNext) { * {@link Consumer} with each upstream item on the current thread until the * upstream terminates. *

- * + * *

* Note: the method will only return if the upstream terminates or the current * thread is interrupted. @@ -5549,7 +5549,7 @@ public final void blockingForEach(@NonNull Consumer onNext, int capac * subscribes to the current {@code Observable} and blocks * until the current {@code Observable} emits items or terminates. *

- * + * *

*
Scheduler:
*
{@code blockingIterable} does not operate by default on a particular {@link Scheduler}.
@@ -5570,7 +5570,7 @@ public final Iterable blockingIterable() { * subscribes to the current {@code Observable} and blocks * until the current {@code Observable} emits items or terminates. *

- * + * *

*
Scheduler:
*
{@code blockingIterable} does not operate by default on a particular {@link Scheduler}.
@@ -5593,7 +5593,7 @@ public final Iterable blockingIterable(int capacityHint) { * Returns the last item emitted by the current {@code Observable}, or throws * {@link NoSuchElementException} if the current {@code Observable} emits no items. *

- * + * *

*
Scheduler:
*
{@code blockingLast} does not operate by default on a particular {@link Scheduler}.
@@ -5625,7 +5625,7 @@ public final T blockingLast() { * Returns the last item emitted by the current {@code Observable}, or a default value if it emits no * items. *

- * + * *

*
Scheduler:
*
{@code blockingLast} does not operate by default on a particular {@link Scheduler}.
@@ -5683,7 +5683,7 @@ public final Iterable blockingLatest() { * Returns an {@link Iterable} that always returns the item most recently emitted by the current * {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code blockingMostRecent} does not operate by default on a particular {@link Scheduler}.
@@ -5708,7 +5708,7 @@ public final Iterable blockingMostRecent(@NonNull T initialItem) { * Returns an {@link Iterable} that blocks until the current {@code Observable} emits another item, then * returns that item. *

- * + * *

*
Scheduler:
*
{@code blockingNext} does not operate by default on a particular {@link Scheduler}.
@@ -5728,7 +5728,7 @@ public final Iterable blockingNext() { * If the current {@code Observable} completes after emitting a single item, return that item, otherwise * throw a {@link NoSuchElementException}. *

- * + * *

*
Scheduler:
*
{@code blockingSingle} does not operate by default on a particular {@link Scheduler}.
@@ -5757,7 +5757,7 @@ public final T blockingSingle() { * more than one item, throw an {@link IllegalArgumentException}; if it emits no items, return a default * value. *

- * + * *

*
Scheduler:
*
{@code blockingSingle} does not operate by default on a particular {@link Scheduler}.
@@ -5935,7 +5935,7 @@ public final void blockingSubscribe(@NonNull Observer observer) { * from the current {@code Observable}. Note that if the current {@code Observable} issues an {@code onError} notification * the event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} does not operate by default on a particular {@link Scheduler}.
@@ -5961,7 +5961,7 @@ public final void blockingSubscribe(@NonNull Observer observer) { * from the current {@code Observable}. Note that if the current {@code Observable} issues an {@code onError} notification * the event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} does not operate by default on a particular {@link Scheduler}.
@@ -5991,7 +5991,7 @@ public final void blockingSubscribe(@NonNull Observer observer) { * from the current {@code Observable}. Note that if the current {@code Observable} issues an {@code onError} notification * the event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} does not operate by default on a particular {@link Scheduler}.
@@ -6029,7 +6029,7 @@ public final > Observable buffer(int count, i * from the current {@code Observable}. Note that if the current {@code Observable} issues an {@code onError} notification * the event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} does not operate by default on a particular {@link Scheduler}.
@@ -6061,7 +6061,7 @@ public final > Observable buffer(int count, i * from the current {@code Observable}. Note that if the current {@code Observable} issues an {@code onError} notification * the event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} operates by default on the {@code computation} {@link Scheduler}.
@@ -6093,7 +6093,7 @@ public final > Observable buffer(int count, i * {@code Observable} issues an {@code onError} notification the event is passed on immediately without first emitting the * buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -6127,7 +6127,7 @@ public final > Observable buffer(int count, i * {@code Observable} issues an {@code onError} notification the event is passed on immediately without first emitting the * buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -6167,7 +6167,7 @@ public final > Observable buffer(int count, i * {@code Observable} issues an {@code onError} notification the event is passed on immediately without first emitting the * buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} operates by default on the {@code computation} {@link Scheduler}.
@@ -6198,7 +6198,7 @@ public final > Observable buffer(int count, i * {@code onError} notification the event is passed on immediately without first emitting the buffer it is in the process of * assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} operates by default on the {@code computation} {@link Scheduler}.
@@ -6232,7 +6232,7 @@ public final > Observable buffer(int count, i * that if the current {@code Observable} issues an {@code onError} notification the event is passed on immediately without * first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -6268,7 +6268,7 @@ public final > Observable buffer(int count, i * that if the current {@code Observable} issues an {@code onError} notification the event is passed on immediately without * first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -6317,7 +6317,7 @@ public final > Observable buffer(int count, i * {@code Observable}. Note that if the current {@code Observable} issues an {@code onError} notification the event is passed on * immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -6348,7 +6348,7 @@ public final > Observable buffer(int count, i * current {@code Observable}, {@code openingIndicator} or {@code closingIndicator} issues an {@code onError} notification the * event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} does not operate by default on a particular {@link Scheduler}.
@@ -6381,7 +6381,7 @@ public final > Observable buffer(int count, i * current {@code Observable}, {@code openingIndicator} or {@code closingIndicator} issues an {@code onError} notification the * event is passed on immediately without first emitting the buffer it is in the process of assembling. *

- * + * *

*
Scheduler:
*
This version of {@code buffer} does not operate by default on a particular {@link Scheduler}.
@@ -6419,7 +6419,7 @@ public final > Observable buffer(int count, i * Returns an {@code Observable} that emits non-overlapping buffered items from the current {@code Observable} each time the * specified boundary {@link ObservableSource} emits an item. *

- * + * *

* Completion of either the source or the boundary {@code ObservableSource} causes the returned {@code ObservableSource} to emit the * latest buffer and complete. If either the current {@code Observable} or the boundary {@code ObservableSource} issues an @@ -6450,7 +6450,7 @@ public final > Observable buffer(int count, i * Returns an {@code Observable} that emits non-overlapping buffered items from the current {@code Observable} each time the * specified boundary {@link ObservableSource} emits an item. *

- * + * *

* Completion of either the source or the boundary {@code ObservableSource} causes the returned {@code ObservableSource} to emit the * latest buffer and complete. If either the current {@code Observable} or the boundary {@code ObservableSource} issues an @@ -6485,7 +6485,7 @@ public final > Observable buffer(int count, i * Returns an {@code Observable} that emits non-overlapping buffered items from the current {@code Observable} each time the * specified boundary {@link ObservableSource} emits an item. *

- * + * *

* Completion of either the source or the boundary {@code ObservableSource} causes the returned {@code ObservableSource} to emit the * latest buffer and complete. If either the current {@code Observable} or the boundary {@code ObservableSource} issues an @@ -6522,7 +6522,7 @@ public final > Observable buffer(int count, i * Returns an {@code Observable} that subscribes to the current {@code Observable} lazily, caches all of its events * and replays them, in the same order as received, to all the downstream observers. *

- * + * *

* This is useful when you want an {@code Observable} to cache responses and you can't control the * subscribe/dispose behavior of all the {@link Observer}s. @@ -6578,7 +6578,7 @@ public final Observable cache() { * Returns an {@code Observable} that subscribes to the current {@code Observable} lazily, caches all of its events * and replays them, in the same order as received, to all the downstream observers. *

- * + * *

* This is useful when you want an {@code Observable} to cache responses and you can't control the * subscribe/dispose behavior of all the {@link Observer}s. @@ -6640,7 +6640,7 @@ public final Observable cacheWithInitialCapacity(int initialCapacity) { * Returns an {@code Observable} that emits the items emitted by the current {@code Observable}, converted to the specified * type. *

- * + * *

*
Scheduler:
*
{@code cast} does not operate by default on a particular {@link Scheduler}.
@@ -6666,7 +6666,7 @@ public final Observable cast(@NonNull Class clazz) { * Collects items emitted by the finite source {@code Observable} into a single mutable data structure and returns * a {@link Single} that emits this structure. *

- * + * *

* This is a simplified version of {@code reduce} that does not need to return the state on each pass. *

@@ -6701,7 +6701,7 @@ public final Single collect(@NonNull Supplier initialItemSup * Collects items emitted by the finite source {@code Observable} into a single mutable data structure and returns * a {@link Single} that emits this structure. *

- * + * *

* This is a simplified version of {@code reduce} that does not need to return the state on each pass. *

@@ -6764,7 +6764,7 @@ public final Observable compose(@NonNull ObservableTransformer - * + * *

* Note that there is no guarantee where the given {@code mapper} function will be executed; it could be on the subscribing thread, * on the upstream thread signaling the new item to be mapped or on the thread where the inner source terminates. To ensure @@ -6795,7 +6795,7 @@ public final Observable concatMap(@NonNull Function - * + * *

* Note that there is no guarantee where the given {@code mapper} function will be executed; it could be on the subscribing thread, * on the upstream thread signaling the new item to be mapped or on the thread where the inner source terminates. To ensure @@ -6839,7 +6839,7 @@ public final Observable concatMap(@NonNull Function - * + * *

* The difference between {@link #concatMap(Function, int)} and this operator is that this operator guarantees the {@code mapper} * function is executed on the specified scheduler. @@ -7174,7 +7174,7 @@ public final Completable concatMapCompletable(@NonNull Function - * + * *

*
Scheduler:
*
{@code concatMapCompletableDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7200,7 +7200,7 @@ public final Completable concatMapCompletableDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapCompletableDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7232,7 +7232,7 @@ public final Completable concatMapCompletableDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapCompletableDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7297,7 +7297,7 @@ public final Observable concatMapIterable(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapMaybe} does not operate by default on a particular {@link Scheduler}.
@@ -7325,7 +7325,7 @@ public final Observable concatMapMaybe(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapMaybe} does not operate by default on a particular {@link Scheduler}.
@@ -7358,7 +7358,7 @@ public final Observable concatMapMaybe(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapMaybeDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7386,7 +7386,7 @@ public final Observable concatMapMaybeDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapMaybeDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7420,7 +7420,7 @@ public final Observable concatMapMaybeDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapMaybeDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7458,7 +7458,7 @@ public final Observable concatMapMaybeDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapSingle} does not operate by default on a particular {@link Scheduler}.
@@ -7486,7 +7486,7 @@ public final Observable concatMapSingle(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapSingle} does not operate by default on a particular {@link Scheduler}.
@@ -7519,7 +7519,7 @@ public final Observable concatMapSingle(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapSingleDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7547,7 +7547,7 @@ public final Observable concatMapSingleDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapSingleDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7581,7 +7581,7 @@ public final Observable concatMapSingleDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatMapSingleDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -7618,7 +7618,7 @@ public final Observable concatMapSingleDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code concatWith} does not operate by default on a particular {@link Scheduler}.
@@ -7642,7 +7642,7 @@ public final Observable concatWith(@NonNull ObservableSource oth * Returns an {@code Observable} that emits the items from the current {@code Observable} followed by the success item or error event * of the {@code other} {@link SingleSource}. *

- * + * *

*
Scheduler:
*
{@code concatWith} does not operate by default on a particular {@link Scheduler}.
@@ -7665,7 +7665,7 @@ public final Observable concatWith(@NonNull SingleSource other) * Returns an {@code Observable} that emits the items from the current {@code Observable} followed by the success item or terminal events * of the other {@link MaybeSource}. *

- * + * *

*
Scheduler:
*
{@code concatWith} does not operate by default on a particular {@link Scheduler}.
@@ -7688,7 +7688,7 @@ public final Observable concatWith(@NonNull MaybeSource other) { * Returns an {@code Observable} that emits items from the current {@code Observable} and when it completes normally, the * other {@link CompletableSource} is subscribed to and the returned {@code Observable} emits its terminal events. *

- * + * *

*
Scheduler:
*
{@code concatWith} does not operate by default on a particular {@link Scheduler}.
@@ -7711,7 +7711,7 @@ public final Observable concatWith(@NonNull CompletableSource other) { * Returns a {@link Single} that emits a {@link Boolean} that indicates whether the current {@code Observable} emitted a * specified item. *

- * + * *

*
Scheduler:
*
{@code contains} does not operate by default on a particular {@link Scheduler}.
@@ -7735,7 +7735,7 @@ public final Single contains(@NonNull Object item) { * Returns a {@link Single} that counts the total number of items emitted by the current {@code Observable} and emits * this count as a 64-bit {@link Long}. *

- * + * *

*
Scheduler:
*
{@code count} does not operate by default on a particular {@link Scheduler}.
@@ -7756,7 +7756,7 @@ public final Single count() { * current {@code Observable} that are followed by another item within a computed debounce duration * denoted by an item emission or completion from a generated inner {@link ObservableSource} for that original item. *

- * + * *

* The delivery of the item happens on the thread of the first {@code onNext} or {@code onComplete} * signal of the generated {@code ObservableSource} sequence, @@ -7794,7 +7794,7 @@ public final Observable debounce(@NonNull FunctionNote: If items keep being emitted by the current {@code Observable} faster than the timeout then no items * will be emitted by the resulting {@code Observable}. *

- * + * *

* Delivery of the item after the grace period happens on the {@code computation} {@link Scheduler}'s * {@code Worker} which if takes too long, a newer item may arrive from the upstream, causing the @@ -7833,7 +7833,7 @@ public final Observable debounce(long timeout, @NonNull TimeUnit unit) { * Note: If items keep being emitted by the current {@code Observable} faster than the timeout then no items * will be emitted by the resulting {@code Observable}. *

- * + * *

* Delivery of the item after the grace period happens on the given {@code Scheduler}'s * {@code Worker} which if takes too long, a newer item may arrive from the upstream, causing the @@ -7872,7 +7872,7 @@ public final Observable debounce(long timeout, @NonNull TimeUnit unit, @NonNu * Returns an {@code Observable} that emits the items emitted by the current {@code Observable} or a specified default item * if the current {@code Observable} is empty. *

- * + * *

*
Scheduler:
*
{@code defaultIfEmpty} does not operate by default on a particular {@link Scheduler}.
@@ -7896,7 +7896,7 @@ public final Observable defaultIfEmpty(@NonNull T defaultItem) { * Returns an {@code Observable} that delays the emissions of the current {@code Observable} via * a per-item derived {@link ObservableSource}'s item emission or termination, on a per source item basis. *

- * + * *

* Note: the resulting {@code Observable} will immediately propagate any {@code onError} notification * from the current {@code Observable}. @@ -7927,7 +7927,7 @@ public final Observable delay(@NonNull Function - * + * *

*
Scheduler:
*
This version of {@code delay} operates by default on the {@code computation} {@link Scheduler}.
@@ -7954,7 +7954,7 @@ public final Observable delay(long time, @NonNull TimeUnit unit) { * Returns an {@code Observable} that emits the items emitted by the current {@code Observable} shifted forward in time by a * specified delay. If {@code delayError} is {@code true}, error notifications will also be delayed. *

- * + * *

*
Scheduler:
*
This version of {@code delay} operates by default on the {@code computation} {@link Scheduler}.
@@ -7983,7 +7983,7 @@ public final Observable delay(long time, @NonNull TimeUnit unit, boolean dela * Returns an {@code Observable} that emits the items emitted by the current {@code Observable} shifted forward in time by a * specified delay. An error notification from the current {@code Observable} is not delayed. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -8010,7 +8010,7 @@ public final Observable delay(long time, @NonNull TimeUnit unit, @NonNull Sch * Returns an {@code Observable} that emits the items emitted by the current {@code Observable} shifted forward in time by a * specified delay. If {@code delayError} is {@code true}, error notifications will also be delayed. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -8043,7 +8043,7 @@ public final Observable delay(long time, @NonNull TimeUnit unit, @NonNull Sch * Returns an {@code Observable} that delays the subscription to and emissions from the current {@code Observable} via * {@link ObservableSource}s for the subscription itself and on a per-item basis. *

- * + * *

* Note: the resulting {@code Observable} will immediately propagate any {@code onError} notification * from the current {@code Observable}. @@ -8079,7 +8079,7 @@ public final Observable delay(@NonNull ObservableSource subscriptio * Returns an {@code Observable} that delays the subscription to the current {@code Observable} * until the other {@link ObservableSource} emits an element or completes normally. *

- * + * *

*
Scheduler:
*
This method does not operate by default on a particular {@link Scheduler}.
@@ -8103,7 +8103,7 @@ public final Observable delaySubscription(@NonNull ObservableSource su /** * Returns an {@code Observable} that delays the subscription to the current {@code Observable} by a given amount of time. *

- * + * *

*
Scheduler:
*
This version of {@code delaySubscription} operates by default on the {@code computation} {@link Scheduler}.
@@ -8128,7 +8128,7 @@ public final Observable delaySubscription(long time, @NonNull TimeUnit unit) * Returns an {@code Observable} that delays the subscription to the current {@code Observable} by a given amount of time, * both waiting and subscribing on a given {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -8156,7 +8156,7 @@ public final Observable delaySubscription(long time, @NonNull TimeUnit unit, * {@link Notification} objects extracted from the source items via a selector function * into their respective {@link Observer} signal types. *

- * + * *

* The intended use of the {@code selector} function is to perform a * type-safe identity mapping (see example) on a source that is already of type @@ -8210,7 +8210,7 @@ public final Observable dematerialize(@NonNull Function - * + * *

* It is recommended the elements' class {@code T} in the flow overrides the default {@code Object.equals()} * and {@link Object#hashCode()} to provide meaningful comparison between items as the default Java @@ -8248,7 +8248,7 @@ public final Observable distinct() { * to a key selector function and based on {@link Object#equals(Object)} comparison of the objects * returned by the key selector function. *

- * + * *

* It is recommended the keys' class {@code K} overrides the default {@code Object.equals()} * and {@link Object#hashCode()} to provide meaningful comparison between the key objects as the default @@ -8290,7 +8290,7 @@ public final Observable distinct(@NonNull Function keySelec * to a key selector function and based on {@link Object#equals(Object)} comparison of the objects * returned by the key selector function. *

- * + * *

* It is recommended the keys' class {@code K} overrides the default {@code Object.equals()} * and {@link Object#hashCode()} to provide meaningful comparison between the key objects as @@ -8324,7 +8324,7 @@ public final Observable distinct(@NonNull Function keySelec * Returns an {@code Observable} that emits all items emitted by the current {@code Observable} that are distinct from their * immediate predecessors based on {@link Object#equals(Object)} comparison. *

- * + * *

* It is recommended the elements' class {@code T} in the flow overrides the default {@code Object.equals()} to provide * meaningful comparison between items as the default Java implementation only considers reference equivalence. @@ -8362,7 +8362,7 @@ public final Observable distinctUntilChanged() { * immediate predecessors, according to a key selector function and based on {@link Object#equals(Object)} comparison * of those objects returned by the key selector function. *

- * + * *

* It is recommended the keys' class {@code K} overrides the default {@code Object.equals()} to provide * meaningful comparison between the key objects as the default Java implementation only considers reference equivalence. @@ -8405,7 +8405,7 @@ public final Observable distinctUntilChanged(@NonNull Function - * + * *

* Note that the operator always retains the latest item from upstream regardless of the comparison result * and uses it in the next comparison with the next upstream item. @@ -8442,7 +8442,7 @@ public final Observable distinctUntilChanged(@NonNull BiPredicate - * + * *

*
Scheduler:
*
{@code doAfterNext} does not operate by default on a particular {@link Scheduler}.
@@ -8467,7 +8467,7 @@ public final Observable doAfterNext(@NonNull Consumer onAfterNext) * Registers an {@link Action} to be called when the current {@code Observable} invokes either * {@link Observer#onComplete onComplete} or {@link Observer#onError onError}. *

- * + * *

*
Scheduler:
*
{@code doAfterTerminate} does not operate by default on a particular {@link Scheduler}.
@@ -8526,7 +8526,7 @@ public final Observable doFinally(@NonNull Action onFinally) { * If the action throws a runtime exception, that exception is rethrown by the {@code dispose()} call, * sometimes as a {@link CompositeException} if there were multiple exceptions along the way. *

- * + * *

*
Scheduler:
*
{@code doOnDispose} does not operate by default on a particular {@link Scheduler}.
@@ -8548,7 +8548,7 @@ public final Observable doOnDispose(@NonNull Action onDispose) { /** * Returns an {@code Observable} that invokes an {@link Action} when the current {@code Observable} calls {@code onComplete}. *

- * + * *

*
Scheduler:
*
{@code doOnComplete} does not operate by default on a particular {@link Scheduler}.
@@ -8571,7 +8571,7 @@ public final Observable doOnComplete(@NonNull Action onComplete) { * Calls the appropriate {@code onXXX} consumer (shared between all {@link Observer}s) whenever a signal with the same type * passes through, before forwarding them to the downstream. *

- * + * *

*
Scheduler:
*
{@code doOnEach} does not operate by default on a particular {@link Scheduler}.
@@ -8596,7 +8596,7 @@ private Observable doOnEach(@NonNull Consumer onNext, @NonNull Con * Returns an {@code Observable} that invokes a {@link Consumer} with the appropriate {@link Notification} * object when the current {@code Observable} signals an item or terminates. *

- * + * *

*
Scheduler:
*
{@code doOnEach} does not operate by default on a particular {@link Scheduler}.
@@ -8630,7 +8630,7 @@ public final Observable doOnEach(@NonNull Consumer> o * {@code onNext} or the {@code onComplete} method of the supplied observer throws, the downstream will be * terminated and will receive this thrown exception. *

- * + * *

*
Scheduler:
*
{@code doOnEach} does not operate by default on a particular {@link Scheduler}.
@@ -8662,7 +8662,7 @@ public final Observable doOnEach(@NonNull Observer observer) { * In case the {@code onError} action throws, the downstream will receive a composite exception containing * the original exception and the exception thrown by {@code onError}. *

- * + * *

*
Scheduler:
*
{@code doOnError} does not operate by default on a particular {@link Scheduler}.
@@ -8685,7 +8685,7 @@ public final Observable doOnError(@NonNull Consumer onErro * Calls the appropriate {@code onXXX} method (shared between all {@link Observer}s) for the lifecycle events of * the sequence (subscription, disposal). *

- * + * *

*
Scheduler:
*
{@code doOnLifecycle} does not operate by default on a particular {@link Scheduler}.
@@ -8711,7 +8711,7 @@ public final Observable doOnLifecycle(@NonNull Consumer o /** * Calls the given {@link Consumer} with the value emitted by the current {@code Observable} before forwarding it to the downstream. *

- * + * *

*
Scheduler:
*
{@code doOnNext} does not operate by default on a particular {@link Scheduler}.
@@ -8736,7 +8736,7 @@ public final Observable doOnNext(@NonNull Consumer onNext) { * current {@code Observable} is reference counted, in which case the current {@code Observable} will invoke * the given action for the first subscription. *

- * + * *

*
Scheduler:
*
{@code doOnSubscribe} does not operate by default on a particular {@link Scheduler}.
@@ -8873,7 +8873,7 @@ public final Single elementAtOrError(long index) { /** * Filters items emitted by the current {@code Observable} by only emitting those that satisfy a specified {@link Predicate}. *

- * + * *

*
Scheduler:
*
{@code filter} does not operate by default on a particular {@link Scheduler}.
@@ -8962,7 +8962,7 @@ public final Single firstOrError() { * by the current {@code Observable}, where that function returns an {@link ObservableSource}, and then merging those returned * {@code ObservableSource}s and emitting the results of this merger. *

- * + * *

*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9098,7 +9098,7 @@ public final Observable flatMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9136,7 +9136,7 @@ public final Observable flatMap( * {@code Observable} and then flattens the {@link ObservableSource}s returned from these functions and emits the resulting items, * while limiting the maximum number of concurrent subscriptions to these {@code ObservableSource}s. *

- * + * *

*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9209,7 +9209,7 @@ public final Observable flatMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9240,7 +9240,7 @@ public final Observable flatMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9275,7 +9275,7 @@ public final Observable flatMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9314,7 +9314,7 @@ public final Observable flatMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9357,7 +9357,7 @@ public final Observable flatMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMap} does not operate by default on a particular {@link Scheduler}.
@@ -9498,7 +9498,7 @@ public final Observable flatMapIterable(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMapMaybe} does not operate by default on a particular {@link Scheduler}.
@@ -9520,7 +9520,7 @@ public final Observable flatMapMaybe(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMapMaybe} does not operate by default on a particular {@link Scheduler}.
@@ -9544,7 +9544,7 @@ public final Observable flatMapMaybe(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMapSingle} does not operate by default on a particular {@link Scheduler}.
@@ -9566,7 +9566,7 @@ public final Observable flatMapSingle(@NonNull Function - * + * *
*
Scheduler:
*
{@code flatMapSingle} does not operate by default on a particular {@link Scheduler}.
@@ -9706,7 +9706,7 @@ public final Disposable forEachWhile(@NonNull Predicate onNext, @NonN * Groups the items emitted by the current {@code Observable} according to a specified criterion, and emits these * grouped items as {@link GroupedObservable}s. *

- * + * *

* Each emitted {@code GroupedObservable} allows only a single {@link Observer} to subscribe to it during its * lifetime and if this {@code Observer} calls {@code dispose()} before the @@ -9748,7 +9748,7 @@ public final Observable> groupBy(@NonNull Function - * + * *

* Each emitted {@code GroupedObservable} allows only a single {@link Observer} to subscribe to it during its * lifetime and if this {@code Observer} calls {@code dispose()} before the @@ -9793,7 +9793,7 @@ public final Observable> groupBy(@NonNull Function - * + * *

* Each emitted {@code GroupedObservable} allows only a single {@link Observer} to subscribe to it during its * lifetime and if this {@code Observer} calls {@code dispose()} before the @@ -9839,7 +9839,7 @@ public final Observable> groupBy(@NonNull Functio * Groups the items emitted by the current {@code Observable} according to a specified criterion, and emits these * grouped items as {@link GroupedObservable}s. *

- * + * *

* Each emitted {@code GroupedObservable} allows only a single {@link Observer} to subscribe to it during its * lifetime and if this {@code Observer} calls {@code dispose()} before the @@ -9888,7 +9888,7 @@ public final Observable> groupBy(@NonNull Functio * Groups the items emitted by the current {@code Observable} according to a specified criterion, and emits these * grouped items as {@link GroupedObservable}s. *

- * + * *

* Each emitted {@code GroupedObservable} allows only a single {@link Observer} to subscribe to it during its * lifetime and if this {@code Observer} calls {@code dispose()} before the @@ -9947,7 +9947,7 @@ public final Observable> groupBy(@NonNull Functio * There are no guarantees in what order the items get combined when multiple * items from one or both source {@code ObservableSource}s overlap. *

- * + * *

*
Scheduler:
*
{@code groupJoin} does not operate by default on a particular {@link Scheduler}.
@@ -10015,7 +10015,7 @@ public final Observable hide() { /** * Ignores all items emitted by the current {@code Observable} and only calls {@code onComplete} or {@code onError}. *

- * + * *

*
Scheduler:
*
{@code ignoreElements} does not operate by default on a particular {@link Scheduler}.
@@ -10037,7 +10037,7 @@ public final Completable ignoreElements() { * In Rx.Net this is negated as the {@code any} {@link Observer} but we renamed this in RxJava to better match Java * naming idioms. *

- * + * *

*
Scheduler:
*
{@code isEmpty} does not operate by default on a particular {@link Scheduler}.
@@ -10059,7 +10059,7 @@ public final Single isEmpty() { * There are no guarantees in what order the items get combined when multiple * items from one or both source {@code ObservableSource}s overlap. *

- * + * *

*
Scheduler:
*
{@code join} does not operate by default on a particular {@link Scheduler}.
@@ -10105,7 +10105,7 @@ public final Observable join( * Returns a {@link Maybe} that emits the last item emitted by the current {@code Observable} or * completes if the current {@code Observable} is empty. *

- * + * *

*
Scheduler:
*
{@code lastElement} does not operate by default on a particular {@link Scheduler}.
@@ -10125,7 +10125,7 @@ public final Maybe lastElement() { * Returns a {@link Single} that emits only the last item emitted by the current {@code Observable}, or a default item * if the current {@code Observable} completes without emitting any items. *

- * + * *

*
Scheduler:
*
{@code last} does not operate by default on a particular {@link Scheduler}.
@@ -10320,7 +10320,7 @@ public final Observable lift(@NonNull ObservableOperator - * + * *
*
Scheduler:
*
{@code map} does not operate by default on a particular {@link Scheduler}.
@@ -10345,7 +10345,7 @@ public final Observable map(@NonNull Function map * Returns an {@code Observable} that represents all of the emissions and notifications from the current * {@code Observable} into emissions marked with their original types within {@link Notification} objects. *

- * + * *

*
Scheduler:
*
{@code materialize} does not operate by default on a particular {@link Scheduler}.
@@ -10365,7 +10365,7 @@ public final Observable> materialize() { /** * Flattens the current {@code Observable} and another {@link ObservableSource} into a single {@code Observable} sequence, without any transformation. *

- * + * *

* You can combine items emitted by multiple {@code ObservableSource}s so that they appear as a single {@code ObservableSource}, by * using the {@code mergeWith} method. @@ -10391,7 +10391,7 @@ public final Observable mergeWith(@NonNull ObservableSource othe /** * Merges the sequence of items of the current {@code Observable} with the success value of the other {@link SingleSource}. *

- * + * *

* The success value of the other {@code SingleSource} can get interleaved at any point of the current * {@code Observable} sequence. @@ -10417,7 +10417,7 @@ public final Observable mergeWith(@NonNull SingleSource other) { * Merges the sequence of items of the current {@code Observable} with the success value of the other {@link MaybeSource} * or waits both to complete normally if the {@code MaybeSource} is empty. *

- * + * *

* The success value of the other {@code MaybeSource} can get interleaved at any point of the current * {@code Observable} sequence. @@ -10443,7 +10443,7 @@ public final Observable mergeWith(@NonNull MaybeSource other) { * Relays the items of the current {@code Observable} and completes only when the other {@link CompletableSource} completes * as well. *

- * + * *

*
Scheduler:
*
{@code mergeWith} does not operate by default on a particular {@link Scheduler}.
@@ -10469,7 +10469,7 @@ public final Observable mergeWith(@NonNull CompletableSource other) { *

Note that {@code onError} notifications will cut ahead of {@code onNext} notifications on the emission thread if {@code Scheduler} is truly * asynchronous. If strict event ordering is required, consider using the {@link #observeOn(Scheduler, boolean)} overload. *

- * + * *

* This operator keeps emitting as many signals as it can on the given {@code Scheduler}'s worker thread, * which may result in a longer than expected occupation of this thread. In other terms, @@ -10504,7 +10504,7 @@ public final Observable observeOn(@NonNull Scheduler scheduler) { * Returns an {@code Observable} to perform the current {@code Observable}'s emissions and notifications on a specified {@link Scheduler}, * asynchronously with an unbounded buffer with {@link Flowable#bufferSize()} "island size" and optionally delays {@code onError} notifications. *

- * + * *

* This operator keeps emitting as many signals as it can on the given {@code Scheduler}'s worker thread, * which may result in a longer than expected occupation of this thread. In other terms, @@ -10543,7 +10543,7 @@ public final Observable observeOn(@NonNull Scheduler scheduler, boolean delay * Returns an {@code Observable} to perform the current {@code Observable}'s emissions and notifications on a specified {@link Scheduler}, * asynchronously with an unbounded buffer of configurable "island size" and optionally delays {@code onError} notifications. *

- * + * *

* This operator keeps emitting as many signals as it can on the given {@code Scheduler}'s worker thread, * which may result in a longer than expected occupation of this thread. In other terms, @@ -10585,7 +10585,7 @@ public final Observable observeOn(@NonNull Scheduler scheduler, boolean delay /** * Filters the items emitted by the current {@code Observable}, only emitting those of the specified type. *

- * + * *

*
Scheduler:
*
{@code ofType} does not operate by default on a particular {@link Scheduler}.
@@ -10653,7 +10653,7 @@ public final Observable onErrorComplete(@NonNull Predicate * Resumes the flow with an {@link ObservableSource} returned for the failure {@link Throwable} of the current {@code Observable} by a * function instead of signaling the error via {@code onError}. *

- * + * *

* By default, when an {@code ObservableSource} encounters an error that prevents it from emitting the expected item to * its {@link Observer}, the {@code ObservableSource} invokes its {@code Observer}'s {@code onError} method, and then quits @@ -10691,7 +10691,7 @@ public final Observable onErrorResumeNext(@NonNull Function - * + * *

* By default, when an {@code ObservableSource} encounters an error that prevents it from emitting the expected item to * its {@link Observer}, the {@code ObservableSource} invokes its {@code Observer}'s {@code onError} method, and then quits @@ -10729,7 +10729,7 @@ public final Observable onErrorResumeWith(@NonNull ObservableSource - * + * *

* By default, when an {@link ObservableSource} encounters an error that prevents it from emitting the expected item to * its {@link Observer}, the {@code ObservableSource} invokes its {@code Observer}'s {@code onError} method, and then quits @@ -10763,7 +10763,7 @@ public final Observable onErrorReturn(@NonNull Function - * + * *

* By default, when an {@link ObservableSource} encounters an error that prevents it from emitting the expected item to * its {@link Observer}, the {@code ObservableSource} invokes its {@code Observer}'s {@code onError} method, and then quits @@ -10819,7 +10819,7 @@ public final Observable onTerminateDetach() { * {@link ConnectableObservable#connect connect} method is called before it begins emitting items to those * {@link Observer}s that have subscribed to it. *

- * + * *

*
Scheduler:
*
{@code publish} does not operate by default on a particular {@link Scheduler}.
@@ -10869,7 +10869,7 @@ public final Observable publish(@NonNull Function, * {@code Observable} into the same function, and so on until all items have been emitted by the current and finite {@code Observable}, * and emits the final result from the final call to your function as its sole item. *

- * + * *

* This technique, which is called "reduce" here, is sometimes called "aggregate," "fold," "accumulate," * "compress," or "inject" in other programming contexts. Groovy, for instance, has an {@code inject} method @@ -10905,7 +10905,7 @@ public final Maybe reduce(@NonNull BiFunction reducer) { * emitted by the current {@code Observable} into the same function, and so on until all items have been emitted by the * current and finite {@code Observable}, emitting the final result from the final call to your function as its sole item. *

- * + * *

* This technique, which is called "reduce" here, is sometimes called "aggregate," "fold," "accumulate," * "compress," or "inject" in other programming contexts. Groovy, for instance, has an {@code inject} method @@ -10965,7 +10965,7 @@ public final Maybe reduce(@NonNull BiFunction reducer) { * and so on until all items have been emitted by the current and finite {@code Observable}, emitting the final result * from the final call to your function as its sole item. *

- * + * *

* This technique, which is called "reduce" here, is sometimes called "aggregate," "fold," "accumulate," * "compress," or "inject" in other programming contexts. Groovy, for instance, has an {@code inject} method @@ -11084,7 +11084,7 @@ public final Observable repeatUntil(@NonNull BooleanSupplier stop) { * call {@code onComplete} or {@code onError} on the child subscription. Otherwise, the current {@code Observable} * will be resubscribed. *

- * + * *

*
Scheduler:
*
{@code repeatWhen} does not operate by default on a particular {@link Scheduler}.
@@ -11110,7 +11110,7 @@ public final Observable repeatWhen(@NonNull Function - * + * *
*
Scheduler:
*
This version of {@code replay} does not operate by default on a particular {@link Scheduler}.
@@ -11472,7 +11472,7 @@ public final Observable replay(@NonNull Function, ? * an ordinary {@code Observable}, except that it does not begin emitting items when it is subscribed to, but only * when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -11504,7 +11504,7 @@ public final ConnectableObservable replay(int bufferSize) { * an ordinary {@code Observable}, except that it does not begin emitting items when it is subscribed to, but only * when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -11537,7 +11537,7 @@ public final ConnectableObservable replay(int bufferSize, boolean eagerTrunca * {@code Observable} resembles an ordinary {@code Observable}, except that it does not begin emitting items when it is * subscribed to, but only when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -11578,7 +11578,7 @@ public final ConnectableObservable replay(int bufferSize, long time, @NonNull * To ensure no out-of-date or beyond-bufferSize items are referenced, * use the {@link #replay(int, long, TimeUnit, Scheduler, boolean)} overload with {@code eagerTruncate = true}. *

- * + * *

*
Scheduler:
*
You specify which {@link Scheduler} this operator will use.
@@ -11615,7 +11615,7 @@ public final ConnectableObservable replay(int bufferSize, long time, @NonNull * connectable {@code Observable} resembles an ordinary {@code Observable}, except that it does not begin emitting items * when it is subscribed to, but only when its {@code connect} method is called. *

- * + * *

* Note that due to concurrency requirements, {@code replay(bufferSize)} may hold strong references to more than * {@code bufferSize} source emissions. @@ -11659,7 +11659,7 @@ public final ConnectableObservable replay(int bufferSize, long time, @NonNull * resembles an ordinary {@code Observable}, except that it does not begin emitting items when it is subscribed to, * but only when its {@code connect} method is called. *

- * + * *

*
Scheduler:
*
This version of {@code replay} operates by default on the {@code computation} {@link Scheduler}.
@@ -11686,7 +11686,7 @@ public final ConnectableObservable replay(long time, @NonNull TimeUnit unit) * resembles an ordinary {@code Observable}, except that it does not begin emitting items when it is subscribed to, * but only when its {@code connect} method is called. *

- * + * *

* Note that the internal buffer may retain strong references to the oldest item. To ensure no out-of-date items * are referenced, use the {@link #replay(long, TimeUnit, Scheduler, boolean)} overload with {@code eagerTruncate = true}. @@ -11721,7 +11721,7 @@ public final ConnectableObservable replay(long time, @NonNull TimeUnit unit, * resembles an ordinary {@code Observable}, except that it does not begin emitting items when it is subscribed to, * but only when its {@code connect} method is called. *

- * + * *

* Note that the internal buffer may retain strong references to the oldest item. To ensure no out-of-date items * are referenced, set {@code eagerTruncate = true}. @@ -11756,7 +11756,7 @@ public final ConnectableObservable replay(long time, @NonNull TimeUnit unit, * Returns an {@code Observable} that mirrors the current {@code Observable}, resubscribing to it if it calls {@code onError} * (infinite retry count). *

- * + * *

* If the current {@code Observable} calls {@link Observer#onError}, this method will resubscribe to the current * {@code Observable} rather than propagating the {@code onError} call. @@ -11811,7 +11811,7 @@ public final Observable retry(@NonNull BiPredicate - * + * *

* If the current {@code Observable} calls {@link Observer#onError}, this method will resubscribe to the current * {@code Observable} for a maximum of {@code count} resubscriptions rather than propagating the @@ -11913,7 +11913,7 @@ public final Observable retryUntil(@NonNull BooleanSupplier stop) { * {@code onComplete} or {@code onError} on the child subscription. Otherwise, the current {@code Observable} * will be resubscribed. *

- * + * *

* Example: * @@ -12015,7 +12015,7 @@ public final void safeSubscribe(@NonNull Observer observer) { * Returns an {@code Observable} that emits the most recently emitted item (if any) emitted by the current {@code Observable} * within periodic time intervals. *

- * + * *

*
Scheduler:
*
{@code sample} operates by default on the {@code computation} {@link Scheduler}.
@@ -12073,7 +12073,7 @@ public final Observable sample(long period, @NonNull TimeUnit unit, boolean e * Returns an {@code Observable} that emits the most recently emitted item (if any) emitted by the current {@code Observable} * within periodic time intervals, where the intervals are defined on a particular {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -12201,7 +12201,7 @@ public final Observable sample(@NonNull ObservableSource sampler, bool * {@code Observable} into the same function, and so on until all items have been emitted by the current {@code Observable}, * emitting the result of each of these iterations. *

- * + * *

* This sort of function is sometimes called an accumulator. *

@@ -12231,7 +12231,7 @@ public final Observable scan(@NonNull BiFunction accumulator) { * the current {@code Observable} into the same function, and so on until all items have been emitted by the current * {@code Observable}, emitting the result of each of these iterations. *

- * + * *

* This sort of function is sometimes called an accumulator. *

@@ -12281,7 +12281,7 @@ public final Observable scan(@NonNull R initialValue, @NonNull BiFunction * the current {@code Observable} into the same function, and so on until all items have been emitted by the current * {@code Observable}, emitting the result of each of these iterations. *

- * + * *

* This sort of function is sometimes called an accumulator. *

@@ -12322,7 +12322,7 @@ public final Observable scanWith(@NonNull Supplier seedSupplier, @NonN * {@code onNext} from two different threads concurrently. You can force such an {@code Observable} to be * well-behaved and sequential by applying the {@code serialize} method to it. *

- * + * *

*
Scheduler:
*
{@code serialize} does not operate by default on a particular {@link Scheduler}.
@@ -12345,7 +12345,7 @@ public final Observable serialize() { *

* This is an alias for {@link #publish()}.{@link ConnectableObservable#refCount() refCount()}. *

- * + * *

*
Scheduler:
*
{@code share} does not operate by default on a particular {@link Scheduler}.
@@ -12366,7 +12366,7 @@ public final Observable share() { * emitted by the current {@code Observable}, or signals an {@link IllegalArgumentException} if the current * {@code Observable} emits more than one item. *

- * + * *

*
Scheduler:
*
{@code singleElement} does not operate by default on a particular {@link Scheduler}.
@@ -12387,7 +12387,7 @@ public final Maybe singleElement() { * emits only a single item, or a default item if the current {@code Observable} emits no items. If the current * {@code Observable} emits more than one item, an {@link IllegalArgumentException} is signaled instead. *

- * + * *

*
Scheduler:
*
{@code single} does not operate by default on a particular {@link Scheduler}.
@@ -12433,7 +12433,7 @@ public final Single singleOrError() { * Returns an {@code Observable} that skips the first {@code count} items emitted by the current {@code Observable} and emits * the remainder. *

- * + * *

*
Scheduler:
*
This version of {@code skip} does not operate by default on a particular {@link Scheduler}.
@@ -12462,7 +12462,7 @@ public final Observable skip(long count) { * Returns an {@code Observable} that skips values emitted by the current {@code Observable} before a specified time window * elapses. *

- * + * *

*
Scheduler:
*
{@code skip} does not operate on any particular scheduler but uses the current time @@ -12488,7 +12488,7 @@ public final Observable skip(long time, @NonNull TimeUnit unit) { * Returns an {@code Observable} that skips values emitted by the current {@code Observable} before a specified time window * on a specified {@link Scheduler} elapses. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use for the timed skipping
@@ -12515,7 +12515,7 @@ public final Observable skip(long time, @NonNull TimeUnit unit, @NonNull Sche * Returns an {@code Observable} that drops a specified number of items from the end of the sequence emitted by the * current {@code Observable}. *

- * + * *

* This {@link Observer} accumulates a queue long enough to store the first {@code count} items. As more items are * received, items are taken from the front of the queue and emitted by the returned {@code Observable}. This causes @@ -12549,7 +12549,7 @@ public final Observable skipLast(int count) { * Returns an {@code Observable} that drops items emitted by the current {@code Observable} during a specified time window * before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -12577,7 +12577,7 @@ public final Observable skipLast(long time, @NonNull TimeUnit unit) { * Returns an {@code Observable} that drops items emitted by the current {@code Observable} during a specified time window * before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -12608,7 +12608,7 @@ public final Observable skipLast(long time, @NonNull TimeUnit unit, boolean d * Returns an {@code Observable} that drops items emitted by the current {@code Observable} during a specified time window * (defined on a specified scheduler) before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -12637,7 +12637,7 @@ public final Observable skipLast(long time, @NonNull TimeUnit unit, @NonNull * Returns an {@code Observable} that drops items emitted by the current {@code Observable} during a specified time window * (defined on a specified scheduler) before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -12669,7 +12669,7 @@ public final Observable skipLast(long time, @NonNull TimeUnit unit, @NonNull * Returns an {@code Observable} that drops items emitted by the current {@code Observable} during a specified time window * (defined on a specified scheduler) before the source completes. *

- * + * *

* Note: this action will cache the latest items arriving in the specified time window. *

@@ -12709,7 +12709,7 @@ public final Observable skipLast(long time, @NonNull TimeUnit unit, @NonNull * Returns an {@code Observable} that skips items emitted by the current {@code Observable} until a second {@link ObservableSource} emits * an item. *

- * + * *

*
Scheduler:
*
{@code skipUntil} does not operate by default on a particular {@link Scheduler}.
@@ -12735,7 +12735,7 @@ public final Observable skipUntil(@NonNull ObservableSource other) { * Returns an {@code Observable} that skips all items emitted by the current {@code Observable} as long as a specified * condition holds {@code true}, but emits all further source items as soon as the condition becomes {@code false}. *

- * + * *

*
Scheduler:
*
{@code skipWhile} does not operate by default on a particular {@link Scheduler}.
@@ -12812,7 +12812,7 @@ public final Observable sorted(@NonNull Comparator comparator) { * Returns an {@code Observable} that emits the items in a specified {@link Iterable} before it begins to emit items * emitted by the current {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code startWithIterable} does not operate by default on a particular {@link Scheduler}.
@@ -12904,7 +12904,7 @@ public final Observable startWith(@NonNull MaybeSource other) { * Returns an {@code Observable} that emits the items in a specified {@link ObservableSource} before it begins to emit * items emitted by the current {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code startWith} does not operate by default on a particular {@link Scheduler}.
@@ -12954,7 +12954,7 @@ public final Observable startWithItem(@NonNull T item) { * Returns an {@code Observable} that emits the specified items before it begins to emit items emitted by the current * {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code startWithArray} does not operate by default on a particular {@link Scheduler}.
@@ -13156,7 +13156,7 @@ public final void subscribe(@NonNull Observer observer) { /** * Asynchronously subscribes {@link Observer}s to the current {@code Observable} on the specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -13210,7 +13210,7 @@ public final Observable switchIfEmpty(@NonNull ObservableSource * The resulting {@code Observable} completes if both the current {@code Observable} and the last inner {@code ObservableSource}, if any, complete. * If the current {@code Observable} signals an {@code onError}, the inner {@code ObservableSource} is disposed and the error delivered in-sequence. *

- * + * *

*
Scheduler:
*
{@code switchMap} does not operate by default on a particular {@link Scheduler}.
@@ -13240,7 +13240,7 @@ public final Observable switchMap(@NonNull Function - * + * *
*
Scheduler:
*
{@code switchMap} does not operate by default on a particular {@link Scheduler}.
@@ -13502,7 +13502,7 @@ public final Observable switchMapSingleDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code switchMapDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -13534,7 +13534,7 @@ public final Observable switchMapDelayError(@NonNull Function - * + * *
*
Scheduler:
*
{@code switchMapDelayError} does not operate by default on a particular {@link Scheduler}.
@@ -13574,7 +13574,7 @@ public final Observable switchMapDelayError(@NonNull Function - * + * *

* This method returns an {@code Observable} that will invoke a subscribing {@link Observer}'s * {@link Observer#onNext onNext} function a maximum of {@code count} times before invoking @@ -13611,7 +13611,7 @@ public final Observable take(long count) { * If time runs out before the {@code Observable} completes normally, the {@code onComplete} event will be * signaled on the default {@code computation} {@link Scheduler}. *

- * + * *

*
Scheduler:
*
This version of {@code take} operates by default on the {@code computation} {@code Scheduler}.
@@ -13639,7 +13639,7 @@ public final Observable take(long time, @NonNull TimeUnit unit) { * If time runs out before the {@code Observable} completes normally, the {@code onComplete} event will be * signaled on the provided {@code Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -13666,7 +13666,7 @@ public final Observable take(long time, @NonNull TimeUnit unit, @NonNull Sche * Returns an {@code Observable} that emits at most the last {@code count} items emitted by the current {@code Observable}. * If the source emits fewer than {@code count} items then all of its items are emitted. *

- * + * *

*
Scheduler:
*
This version of {@code takeLast} does not operate by default on a particular {@link Scheduler}.
@@ -13700,7 +13700,7 @@ public final Observable takeLast(int count) { * Returns an {@code Observable} that emits at most a specified number of items from the current {@code Observable} that were * emitted in a specified window of time before the current {@code Observable} completed. *

- * + * *

*
Scheduler:
*
{@code takeLast} does not operate on any particular scheduler but uses the current time @@ -13730,7 +13730,7 @@ public final Observable takeLast(long count, long time, @NonNull TimeUnit uni * emitted in a specified window of time before the current {@code Observable} completed, where the timing information is * provided by a given {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use for tracking the current time
@@ -13762,7 +13762,7 @@ public final Observable takeLast(long count, long time, @NonNull TimeUnit uni * emitted in a specified window of time before the current {@code Observable} completed, where the timing information is * provided by a given {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use for tracking the current time
@@ -13804,7 +13804,7 @@ public final Observable takeLast(long count, long time, @NonNull TimeUnit uni * Returns an {@code Observable} that emits the items from the current {@code Observable} that were emitted in a specified * window of time before the current {@code Observable} completed. *

- * + * *

*
Scheduler:
*
{@code takeLast} does not operate on any particular scheduler but uses the current time @@ -13830,7 +13830,7 @@ public final Observable takeLast(long time, @NonNull TimeUnit unit) { * Returns an {@code Observable} that emits the items from the current {@code Observable} that were emitted in a specified * window of time before the current {@code Observable} completed. *

- * + * *

*
Scheduler:
*
{@code takeLast} does not operate on any particular scheduler but uses the current time @@ -13861,7 +13861,7 @@ public final Observable takeLast(long time, @NonNull TimeUnit unit, boolean d * window of time before the current {@code Observable} completed, where the timing information is provided by a specified * {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -13889,7 +13889,7 @@ public final Observable takeLast(long time, @NonNull TimeUnit unit, @NonNull * window of time before the current {@code Observable} completed, where the timing information is provided by a specified * {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -13920,7 +13920,7 @@ public final Observable takeLast(long time, @NonNull TimeUnit unit, @NonNull * window of time before the current {@code Observable} completed, where the timing information is provided by a specified * {@link Scheduler}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -13953,7 +13953,7 @@ public final Observable takeLast(long time, @NonNull TimeUnit unit, @NonNull * Returns an {@code Observable} that emits the items emitted by the current {@code Observable} until a second {@link ObservableSource} * emits an item. *

- * + * *

*
Scheduler:
*
{@code takeUntil} does not operate by default on a particular {@link Scheduler}.
@@ -13980,7 +13980,7 @@ public final Observable takeUntil(@NonNull ObservableSource other) { * Returns an {@code Observable} that emits items emitted by the current {@code Observable}, checks the specified predicate * for each item, and then completes when the condition is satisfied. *

- * + * *

* The difference between this operator and {@link #takeWhile(Predicate)} is that here, the condition is * evaluated after the item is emitted. @@ -14010,7 +14010,7 @@ public final Observable takeUntil(@NonNull Predicate stopPredicate * Returns an {@code Observable} that emits items emitted by the current {@code Observable} so long as each item satisfied a * specified condition, and then completes as soon as this condition is not satisfied. *

- * + * *

*
Scheduler:
*
{@code takeWhile} does not operate by default on a particular {@link Scheduler}.
@@ -14038,7 +14038,7 @@ public final Observable takeWhile(@NonNull Predicate predicate) { * This differs from {@link #throttleLast} in that this only tracks passage of time whereas * {@code throttleLast} ticks at scheduled intervals. *

- * + * *

*
Scheduler:
*
{@code throttleFirst} operates by default on the {@code computation} {@link Scheduler}.
@@ -14066,7 +14066,7 @@ public final Observable throttleFirst(long windowDuration, @NonNull TimeUnit * This differs from {@link #throttleLast} in that this only tracks passage of time whereas * {@code throttleLast} ticks at scheduled intervals. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -14099,7 +14099,7 @@ public final Observable throttleFirst(long skipDuration, @NonNull TimeUnit un * This differs from {@link #throttleFirst} in that this ticks along at a scheduled interval whereas * {@code throttleFirst} does not tick, it just tracks passage of time. *

- * + * *

*
Scheduler:
*
{@code throttleLast} operates by default on the {@code computation} {@link Scheduler}.
@@ -14129,7 +14129,7 @@ public final Observable throttleLast(long intervalDuration, @NonNull TimeUnit * This differs from {@link #throttleFirst} in that this ticks along at a scheduled interval whereas * {@code throttleFirst} does not tick, it just tracks passage of time. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -14299,7 +14299,7 @@ public final Observable throttleLatest(long timeout, @NonNull TimeUnit unit, * Note: If items keep being emitted by the current {@code Observable} faster than the timeout then no items * will be emitted by the resulting {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code throttleWithTimeout} operates by default on the {@code computation} {@link Scheduler}.
@@ -14331,7 +14331,7 @@ public final Observable throttleWithTimeout(long timeout, @NonNull TimeUnit u * Note: If items keep being emitted by the current {@code Observable} faster than the timeout then no items * will be emitted by the resulting {@code Observable}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -14362,7 +14362,7 @@ public final Observable throttleWithTimeout(long timeout, @NonNull TimeUnit u * Returns an {@code Observable} that emits records of the time interval between consecutive items emitted by the * current {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code timeInterval} does not operate on any particular scheduler but uses the current time @@ -14383,7 +14383,7 @@ public final Observable> timeInterval() { * Returns an {@code Observable} that emits records of the time interval between consecutive items emitted by the * current {@code Observable}, where this interval is computed on a specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
The operator does not operate on any particular scheduler but uses the current time @@ -14407,7 +14407,7 @@ public final Observable> timeInterval(@NonNull Scheduler scheduler) { * Returns an {@code Observable} that emits records of the time interval between consecutive items emitted by the * current {@code Observable}. *

- * + * *

*
Scheduler:
*
{@code timeInterval} does not operate on any particular scheduler but uses the current time @@ -14430,7 +14430,7 @@ public final Observable> timeInterval(@NonNull TimeUnit unit) { * Returns an {@code Observable} that emits records of the time interval between consecutive items emitted by the * current {@code Observable}, where this interval is computed on a specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
The operator does not operate on any particular scheduler but uses the current time @@ -14459,7 +14459,7 @@ public final Observable> timeInterval(@NonNull TimeUnit unit, @NonNull * time after the emission of the previous item, where that period of time is measured by an {@link ObservableSource} that * is a function of the previous item. *

- * + * *

* Note: The arrival of the first source item is never timed out. *

@@ -14489,7 +14489,7 @@ public final Observable timeout(@NonNull Function - * + * *

* Note: The arrival of the first source item is never timed out. *

@@ -14522,7 +14522,7 @@ public final Observable timeout(@NonNull Function - * + * *
*
Scheduler:
*
This version of {@code timeout} operates by default on the {@code computation} {@link Scheduler}.
@@ -14549,7 +14549,7 @@ public final Observable timeout(long timeout, @NonNull TimeUnit unit) { * the current {@code Observable} is disposed and the resulting {@code Observable} begins instead * to mirror a fallback {@link ObservableSource}. *

- * + * *

*
Scheduler:
*
This version of {@code timeout} operates by default on the {@code computation} {@link Scheduler}.
@@ -14579,7 +14579,7 @@ public final Observable timeout(long timeout, @NonNull TimeUnit unit, @NonNul * starting from its predecessor, the current {@code Observable} is disposed and returned {@code Observable} * begins instead to mirror a fallback {@link ObservableSource}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -14611,7 +14611,7 @@ public final Observable timeout(long timeout, @NonNull TimeUnit unit, @NonNul * specified timeout duration starting from its predecessor, the resulting {@code Observable} terminates and * notifies observers of a {@link TimeoutException}. *

- * + * *

*
Scheduler:
*
You specify which {@code Scheduler} this operator will use.
@@ -14639,7 +14639,7 @@ public final Observable timeout(long timeout, @NonNull TimeUnit unit, @NonNul * {@link TimeoutException} if either the first item emitted by the current {@code Observable} or any subsequent item * doesn't arrive within time windows defined by indicator {@link ObservableSource}s. *

- * + * *

*
Scheduler:
*
This version of {@code timeout} operates by default on the {@code immediate} {@link Scheduler}.
@@ -14674,7 +14674,7 @@ public final Observable timeout(@NonNull ObservableSource firstTime * the first item emitted by the current {@code Observable} or any subsequent item doesn't arrive within time windows * defined by indicator {@code ObservableSource}s. *

- * + * *

*
Scheduler:
*
This version of {@code timeout} operates by default on the {@code immediate} {@link Scheduler}.
@@ -14732,7 +14732,7 @@ private Observable timeout0( * Returns an {@code Observable} that emits each item emitted by the current {@code Observable}, wrapped in a * {@link Timed} object. *

- * + * *

*
Scheduler:
*
{@code timestamp} does not operate on any particular scheduler but uses the current time @@ -14753,7 +14753,7 @@ public final Observable> timestamp() { * Returns an {@code Observable} that emits each item emitted by the current {@code Observable}, wrapped in a * {@link Timed} object whose timestamps are provided by a specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
This operator does not operate on any particular scheduler but uses the current time @@ -14777,7 +14777,7 @@ public final Observable> timestamp(@NonNull Scheduler scheduler) { * Returns an {@code Observable} that emits each item emitted by the current {@code Observable}, wrapped in a * {@link Timed} object. *

- * + * *

*
Scheduler:
*
{@code timestamp} does not operate on any particular scheduler but uses the current time @@ -14800,7 +14800,7 @@ public final Observable> timestamp(@NonNull TimeUnit unit) { * Returns an {@code Observable} that emits each item emitted by the current {@code Observable}, wrapped in a * {@link Timed} object whose timestamps are provided by a specified {@link Scheduler}. *

- * + * *

*
Scheduler:
*
This operator does not operate on any particular scheduler but uses the current time @@ -14849,7 +14849,7 @@ public final R to(@NonNull ObservableConverter converter) { * Returns a {@link Single} that emits a single item, a {@link List} composed of all the items emitted by the * current and finite {@code Observable}. *

- * + * *

* Normally, an {@link ObservableSource} that returns multiple items will do so by invoking its {@link Observer}'s * {@link Observer#onNext onNext} method for each such item. You can change this behavior by having the @@ -14879,7 +14879,7 @@ public final R to(@NonNull ObservableConverter converter) { * Returns a {@link Single} that emits a single item, a {@link List} composed of all the items emitted by the * current and finite {@code Observable}. *

- * + * *

* Normally, an {@link ObservableSource} that returns multiple items will do so by invoking its {@link Observer}'s * {@link Observer#onNext onNext} method for each such item. You can change this behavior by having the @@ -14949,7 +14949,7 @@ public final R to(@NonNull ObservableConverter converter) { * current and finite {@code Observable}, mapped by the keys returned by a specified * {@code keySelector} function. *

- * + * *

* If more than one source item maps to the same key, the {@code HashMap} will contain the latest of those items. *

@@ -14980,7 +14980,7 @@ public final R to(@NonNull ObservableConverter converter) { * Returns a {@link Single} that emits a single {@link HashMap} containing values corresponding to items emitted by the * current and finite {@code Observable}, mapped by the keys and values returned by the given selector functions. *

- * + * *

* If more than one source item maps to the same key, the {@code HashMap} will contain a single entry that * corresponds to the latest of those items. @@ -15018,7 +15018,7 @@ public final Single> toMap( * Returns a {@link Single} that emits a single {@link Map} (subclass), returned by a specified {@code mapFactory} function, that * contains keys and values extracted from the items, via selector functions, emitted by the current and finite {@code Observable}. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code Map} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15057,7 +15057,7 @@ public final Single> toMap( * Returns a {@link Single} that emits a single {@link HashMap} that contains an {@link ArrayList} of items emitted by the * current and finite {@code Observable} keyed by a specified {@code keySelector} function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code HashMap} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15089,7 +15089,7 @@ public final Single> toMap( * specified {@code valueSelector} function from items emitted by the current and finite {@code Observable}, * keyed by a specified {@code keySelector} function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code HashMap} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15123,7 +15123,7 @@ public final Single> toMap( * contains a custom {@link Collection} of values, extracted by a specified {@code valueSelector} function from * items emitted by the current and finite {@code Observable}, and keyed by the {@code keySelector} function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code Map} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15167,7 +15167,7 @@ public final Single> toMap( * contains an {@link ArrayList} of values, extracted by a specified {@code valueSelector} function from items * emitted by the current and finite {@code Observable} and keyed by the {@code keySelector} function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code Map} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15268,7 +15268,7 @@ public final Flowable toFlowable(@NonNull BackpressureStrategy strategy) { * all other items emitted by the current {@code Observable}, no items will be emitted and the * sequence is terminated with a {@link ClassCastException}. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code List} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15293,7 +15293,7 @@ public final Flowable toFlowable(@NonNull BackpressureStrategy strategy) { * Returns a {@link Single} that emits a {@link List} that contains the items emitted by the current and finite {@code Observable}, in a * sorted order based on a specified comparison function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code List} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15322,7 +15322,7 @@ public final Flowable toFlowable(@NonNull BackpressureStrategy strategy) { * Returns a {@link Single} that emits a {@link List} that contains the items emitted by the current and finite {@code Observable}, in a * sorted order based on a specified comparison function. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code List} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15360,7 +15360,7 @@ public final Flowable toFlowable(@NonNull BackpressureStrategy strategy) { * all other items emitted by the current {@code Observable}, no items will be emitted and the * sequence is terminated with a {@link ClassCastException}. *

- * + * *

* Note that this operator requires the upstream to signal {@code onComplete} for the accumulated {@code List} to * be emitted. Sources that are infinite and never complete will never emit anything through this @@ -15415,7 +15415,7 @@ public final Observable unsubscribeOn(@NonNull Scheduler scheduler) { * {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the current window and * propagates the notification from the current {@code Observable}. *

- * + * *

*
Scheduler:
*
This version of {@code window} does not operate by default on a particular {@link Scheduler}.
@@ -15440,7 +15440,7 @@ public final Observable> window(long count) { * the current {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the current window * and propagates the notification from the current {@code Observable}. *

- * + * *

*
Scheduler:
*
This version of {@code window} does not operate by default on a particular {@link Scheduler}.
@@ -15468,7 +15468,7 @@ public final Observable> window(long count, long skip) { * the current {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the current window * and propagates the notification from the current {@code Observable}. *

- * + * *

*
Scheduler:
*
This version of {@code window} does not operate by default on a particular {@link Scheduler}.
@@ -15502,7 +15502,7 @@ public final Observable> window(long count, long skip, int bufferS * {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the * current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15538,7 +15538,7 @@ public final Observable> window(long timespan, long timeskip, @Non * {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the * current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15576,7 +15576,7 @@ public final Observable> window(long timespan, long timeskip, @Non * {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the * current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15620,7 +15620,7 @@ public final Observable> window(long timespan, long timeskip, @Non * {@code timespan} argument. When the current {@code Observable} completes or encounters an error, the resulting * {@code Observable} emits the current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15654,7 +15654,7 @@ public final Observable> window(long timespan, @NonNull TimeUnit u * reached first). When the current {@code Observable} completes or encounters an error, the resulting {@code Observable} * emits the current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15692,7 +15692,7 @@ public final Observable> window(long timespan, @NonNull TimeUnit u * reached first). When the current {@code Observable} completes or encounters an error, the resulting {@code Observable} * emits the current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15731,7 +15731,7 @@ public final Observable> window(long timespan, @NonNull TimeUnit u * {@code timespan} argument. When the current {@code Observable} completes or encounters an error, the resulting * {@code Observable} emits the current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15768,7 +15768,7 @@ public final Observable> window(long timespan, @NonNull TimeUnit u * first). When the current {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the * current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15808,7 +15808,7 @@ public final Observable> window(long timespan, @NonNull TimeUnit u * first). When the current {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the * current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15850,7 +15850,7 @@ public final Observable> window(long timespan, @NonNull TimeUnit u * first). When the current {@code Observable} completes or encounters an error, the resulting {@code Observable} emits the * current window and propagates the notification from the current {@code Observable}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15897,7 +15897,7 @@ public final Observable> window( * where the boundary of each window is determined by the items emitted from a specified boundary-governing * {@link ObservableSource}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15928,7 +15928,7 @@ public final Observable> window(@NonNull ObservableSource b * where the boundary of each window is determined by the items emitted from a specified boundary-governing * {@link ObservableSource}. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -15965,7 +15965,7 @@ public final Observable> window(@NonNull ObservableSource b * the {@code openingIndicator} {@link ObservableSource} emits an item and when the {@code ObservableSource} returned by * {@code closingIndicator} emits an item. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -16002,7 +16002,7 @@ public final Observable> window( * the {@code openingIndicator} {@link ObservableSource} emits an item and when the {@code ObservableSource} returned by * {@code closingIndicator} emits an item. *

- * + * *

* Note that ignoring windows or subscribing later (i.e., on another thread) will result in * so-called window abandonment where a window may not contain any elements. In this case, subsequent @@ -16043,7 +16043,7 @@ public final Observable> window( * Merges the specified {@link ObservableSource} into the current {@code Observable} sequence by using the {@code resultSelector} * function only when the current {@code Observable} emits an item. *

- * + * * *

*
Scheduler:
@@ -16081,7 +16081,7 @@ public final Observable withLatestFrom(@NonNull ObservableSource - * + * *
*
Scheduler:
*
This operator does not operate by default on a particular {@link Scheduler}.
@@ -16119,7 +16119,7 @@ public final Observable withLatestFrom( * not when any of the other sources emit, unlike combineLatest). * If a source doesn't produce any value and just completes, the sequence is completed immediately. *

- * + * *

*
Scheduler:
*
This operator does not operate by default on a particular {@link Scheduler}.
@@ -16161,7 +16161,7 @@ public final Observable withLatestFrom( * not when any of the other sources emit, unlike combineLatest). * If a source doesn't produce any value and just completes, the sequence is completed immediately. *

- * + * *

*
Scheduler:
*
This operator does not operate by default on a particular {@link Scheduler}.
@@ -16207,7 +16207,7 @@ public final Observable withLatestFrom( * not when any of the other sources emit, unlike combineLatest). * If a source doesn't produce any value and just completes, the sequence is completed immediately. *

- * + * *

*
Scheduler:
*
This operator does not operate by default on a particular {@link Scheduler}.
@@ -16238,7 +16238,7 @@ public final Observable withLatestFrom(@NonNull ObservableSource[] oth * not when any of the other sources emit, unlike {@code combineLatest}). * If a source doesn't produce any value and just completes, the sequence is completed immediately. *

- * + * *

*
Scheduler:
*
This operator does not operate by default on a particular {@link Scheduler}.
@@ -16264,7 +16264,7 @@ public final Observable withLatestFrom(@NonNull Iterable<@NonNull ? exten * Returns an {@code Observable} that emits items that are the result of applying a specified function to pairs of * values, one each from the current {@code Observable} and a specified {@link Iterable} sequence. *

- * + * *

* Note that the {@code other} {@code Iterable} is evaluated as items are observed from the current {@code Observable}; it is * not pre-consumed. This allows you to zip infinite streams on either side. @@ -16299,7 +16299,7 @@ public final Observable withLatestFrom(@NonNull Iterable<@NonNull ? exten * Returns an {@code Observable} that emits items that are the result of applying a specified function to pairs of * values, one each from the current {@code Observable} and another specified {@link ObservableSource}. *

- * + * *

* The operator subscribes to its sources in order they are specified and completes eagerly if * one of the sources is shorter than the rest while disposing the other sources. Therefore, it @@ -16343,7 +16343,7 @@ public final Observable zipWith(@NonNull ObservableSource * Returns an {@code Observable} that emits items that are the result of applying a specified function to pairs of * values, one each from the current {@code Observable} and another specified {@link ObservableSource}. *

- * + * *

* The operator subscribes to its sources in order they are specified and completes eagerly if * one of the sources is shorter than the rest while disposing the other sources. Therefore, it @@ -16389,7 +16389,7 @@ public final Observable zipWith(@NonNull ObservableSource * Returns an {@code Observable} that emits items that are the result of applying a specified function to pairs of * values, one each from the current {@code Observable} and another specified {@link ObservableSource}. *

- * + * *

* The operator subscribes to its sources in order they are specified and completes eagerly if * one of the sources is shorter than the rest while disposing the other sources. Therefore, it diff --git a/src/main/java/io/reactivex/rxjava3/core/Single.java b/src/main/java/io/reactivex/rxjava3/core/Single.java index e830589e23..b10706a214 100644 --- a/src/main/java/io/reactivex/rxjava3/core/Single.java +++ b/src/main/java/io/reactivex/rxjava3/core/Single.java @@ -65,7 +65,7 @@ *

* The documentation for this class makes use of marble diagrams. The following legend explains these diagrams: *

- * + * *

* See {@link Flowable} or {@code Observable} for the * implementation of the Reactive Pattern for a stream or vector of values. @@ -119,7 +119,7 @@ public abstract class Single<@NonNull T> implements SingleSource { * Runs multiple {@link SingleSource}s and signals the events of the first one that signals (disposing * the rest). *

- * + * *

*
Scheduler:
*
{@code amb} does not operate by default on a particular {@link Scheduler}.
@@ -143,7 +143,7 @@ public static Single amb(@NonNull Iterable<@NonNull ? extends SingleSourc * Runs multiple {@link SingleSource}s and signals the events of the first one that signals (disposing * the rest). *

- * + * *

*
Scheduler:
*
{@code ambArray} does not operate by default on a particular {@link Scheduler}.
@@ -176,7 +176,7 @@ public static Single ambArray(@NonNull SingleSource... sourc * Concatenate the single values, in a non-overlapping fashion, of the {@link SingleSource}s provided by * an {@link Iterable} sequence. *

- * + * *

*
Backpressure:
*
The returned {@link Flowable} honors the backpressure of the downstream consumer.
@@ -201,7 +201,7 @@ public static Flowable concat(@NonNull Iterable<@NonNull ? extends Single * Concatenate the single values, in a non-overlapping fashion, of the {@link SingleSource}s provided by * an {@link ObservableSource} sequence. *

- * + * *

*
Scheduler:
*
{@code concat} does not operate by default on a particular {@link Scheduler}.
@@ -224,7 +224,7 @@ public static Observable concat(@NonNull ObservableSource - * + * *
*
Backpressure:
*
The returned {@link Flowable} honors the backpressure of the downstream consumer @@ -250,7 +250,7 @@ public static Flowable concat(@NonNull Publisher<@NonNull ? extends Singl * Concatenate the single values, in a non-overlapping fashion, of the {@link SingleSource}s provided by * a {@link Publisher} sequence and prefetched by the specified amount. *

- * + * *

*
Backpressure:
*
The returned {@link Flowable} honors the backpressure of the downstream consumer @@ -279,7 +279,7 @@ public static Flowable concat(@NonNull Publisher<@NonNull ? extends Singl /** * Returns a {@link Flowable} that emits the items emitted by two {@link SingleSource}s, one after the other. *

- * + * *

*
Backpressure:
*
The returned {@code Flowable} honors the backpressure of the downstream consumer.
@@ -311,7 +311,7 @@ public static Flowable concat( /** * Returns a {@link Flowable} that emits the items emitted by three {@link SingleSource}s, one after the other. *

- * + * *

*
Backpressure:
*
The returned {@code Flowable} honors the backpressure of the downstream consumer.
@@ -347,7 +347,7 @@ public static Flowable concat( /** * Returns a {@link Flowable} that emits the items emitted by four {@link SingleSource}s, one after the other. *

- * + * *

*
Backpressure:
*
The returned {@code Flowable} honors the backpressure of the downstream consumer.
@@ -387,7 +387,7 @@ public static Flowable concat( * Concatenate the single values, in a non-overlapping fashion, of the {@link SingleSource}s provided in * an array. *

- * + * *

*
Backpressure:
*
The returned {@link Flowable} honors the backpressure of the downstream consumer.
@@ -581,7 +581,7 @@ public static Flowable concatDelayError(@NonNull Publisher<@NonNull ? ext /** * Concatenates an {@link Iterable} sequence of {@link SingleSource}s eagerly into a single stream of values. *

- * + * *

* Eager concatenation means that once a subscriber subscribes, this operator subscribes to all of the * source {@code SingleSource}s. The operator buffers the values emitted by these {@code SingleSource}s and then drains them @@ -640,7 +640,7 @@ public static Flowable concatEager(@NonNull Iterable<@NonNull ? extends S /** * Concatenates a {@link Publisher} sequence of {@link SingleSource}s eagerly into a single stream of values. *

- * + * *

* Eager concatenation means that once a subscriber subscribes, this operator subscribes to all of the * emitted source {@code SingleSource}s as they are observed. The operator buffers the values emitted by these @@ -829,7 +829,7 @@ public static Flowable concatEagerDelayError(@NonNull Publisher<@NonNull /** * Provides an API (via a cold {@code Single}) that bridges the reactive world with the callback-style world. *

- * + * *

* Example: * 


@@ -881,7 +881,7 @@ public static  Flowable concatEagerDelayError(@NonNull Publisher<@NonNull
      * Calls a {@link Supplier} for each individual {@link SingleObserver} to return the actual {@link SingleSource} to
      * be subscribed to.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code defer} does not operate by default on a particular {@link Scheduler}.

@@ -903,7 +903,7 @@ public static  Single defer(@NonNull Supplier
-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code error} does not operate by default on a particular {@link Scheduler}.

@@ -926,7 +926,7 @@ public static  Single error(@NonNull Supplier supplie
      * Returns a {@code Single} that invokes a subscriber's {@link SingleObserver#onError onError} method when the
      * subscriber subscribes to it.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code error} does not operate by default on a particular {@link Scheduler}.

@@ -957,7 +957,7 @@ public static  Single error(@NonNull Throwable throwable) {
      * It makes passed function "lazy".
      * Result of the function invocation will be emitted by the {@link Single}.
      * 

-     * 
+     * 
      * 

      *   
Scheduler:

      *   
{@code fromCallable} does not operate by default on a particular {@link Scheduler}.

@@ -990,7 +990,7 @@ public static  Single error(@NonNull Throwable throwable) {
     /**
      * Converts a {@link Future} into a {@code Single} and awaits its outcome in a blocking fashion.
      * 

-     * 
+     * 
      * 

      * The operator calls {@link Future#get()}, which is a blocking method, on the subscription thread.
      * It is recommended applying {@link #subscribeOn(Scheduler)} to move this blocking wait to a
@@ -1026,7 +1026,7 @@ public static  Single error(@NonNull Throwable throwable) {
     /**
      * Converts a {@link Future} into a {@code Single} and awaits its outcome, or timeout, in a blocking fashion.
      * 

-     * 
+     * 
      * 

      * The operator calls {@link Future#get(long, TimeUnit)}, which is a blocking method, on the subscription thread.
      * It is recommended applying {@link #subscribeOn(Scheduler)} to move this blocking wait to a
@@ -1114,7 +1114,7 @@ public static  Single fromMaybe(@NonNull MaybeSource maybe, @NonNull T
     /**
      * Wraps a specific {@link Publisher} into a {@code Single} and signals its single element or error.
      * 

-     * 
+     * 
      * 

      * If the source {@code Publisher} is empty, a {@link NoSuchElementException} is signaled. If
      * the source has more than one element, an {@link IndexOutOfBoundsException} is signaled.
@@ -1154,7 +1154,7 @@ public static  Single fromPublisher(@NonNull Publisher<@NonNull ? extends
     /**
      * Wraps a specific {@link ObservableSource} into a {@code Single} and signals its single element or error.
      * 

-     * 
+     * 
      * 

      * If the {@code ObservableSource} is empty, a {@link NoSuchElementException} is signaled.
      * If the source has more than one element, an {@link IndexOutOfBoundsException} is signaled.
@@ -1185,7 +1185,7 @@ public static  Single fromObservable(@NonNull ObservableSource
-     * 
+     * 
      * 

      *   
Scheduler:

      *   
{@code fromSupplier} does not operate by default on a particular {@link Scheduler}.

@@ -1219,7 +1219,7 @@ public static  Single fromObservable(@NonNull ObservableSource
-     * 
+     * 
      * 

      * To convert any object into a {@code Single} that emits that object, pass that object into the
      * {@code just} method.
@@ -1248,7 +1248,7 @@ public static  Single fromObservable(@NonNull ObservableSource
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -1287,7 +1287,7 @@ public static  Flowable merge(@NonNull Iterable<@NonNull ? extends SingleS
      * Merges a sequence of {@link SingleSource} instances emitted by a {@link Publisher} into a single {@link Flowable} sequence,
      * running all {@code SingleSource}s at once.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -1327,7 +1327,7 @@ public static  Flowable merge(@NonNull Publisher<@NonNull ? extends Single
      * Flattens a {@link SingleSource} that emits a {@code SingleSingle} into a single {@code Single} that emits the item
      * emitted by the nested {@code SingleSource}, without any transformation.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code merge} does not operate by default on a particular {@link Scheduler}.

@@ -1357,7 +1357,7 @@ public static  Single merge(@NonNull SingleSource
-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code SingleSource}s so that they appear as a single {@code Flowable}, by
      * using the {@code merge} method.
@@ -1406,7 +1406,7 @@ public static  Flowable merge(
     /**
      * Flattens three {@link SingleSource}s into one {@link Flowable} sequence, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code SingleSource}s so that they appear as a single {@code Flowable}, by
      * the {@code merge} method.
@@ -1459,7 +1459,7 @@ public static  Flowable merge(
     /**
      * Flattens four {@link SingleSource}s into one {@link Flowable} sequence, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code SingleSource}s so that they appear as a single {@code Flowable}, by
      * the {@code merge} method.
@@ -1770,7 +1770,7 @@ public static  Flowable mergeDelayError(
     /**
      * Returns a singleton instance of a never-signaling {@code Single} (only calls {@code onSubscribe}).
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code never} does not operate by default on a particular {@link Scheduler}.

@@ -1790,7 +1790,7 @@ public static  Single never() {
     /**
      * Signals success with 0L value after the given delay when a {@link SingleObserver} subscribes.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code timer} operates by default on the {@code computation} {@link Scheduler}.

@@ -1812,7 +1812,7 @@ public static Single timer(long delay, @NonNull TimeUnit unit) {
      * Signals success with 0L value on the specified {@link Scheduler} after the given
      * delay when a {@link SingleObserver} subscribes.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
you specify the {@code Scheduler} to signal on.

@@ -1838,7 +1838,7 @@ public static Single timer(long delay, @NonNull TimeUnit unit, @NonNull Sc
     /**
      * Compares two {@link SingleSource}s and emits {@code true} if they emit the same value (compared via {@link Object#equals(Object)}).
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code sequenceEqual} does not operate by default on a particular {@link Scheduler}.

@@ -1961,7 +1961,7 @@ public static  Single unsafeCreate(@NonNull SingleSource onSubscribe) {
      * Allows using and disposing a resource while running a {@link SingleSource} instance generated from
      * that resource (similar to a try-with-resources).
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code using} does not operate by default on a particular {@link Scheduler}.

@@ -2570,7 +2570,7 @@ public static  Single zipArray(@NonNull Function
-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code ambWith} does not operate by default on a particular {@link Scheduler}.

@@ -2593,7 +2593,7 @@ public final Single ambWith(@NonNull SingleSource other) {
      * Hides the identity of the current {@code Single}, including the {@link Disposable} that is sent
      * to the downstream via {@code onSubscribe()}.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code hide} does not operate by default on a particular {@link Scheduler}.

@@ -2611,7 +2611,7 @@ public final Single hide() {
     /**
      * Transform a {@code Single} by applying a particular {@link SingleTransformer} function to it.
      * 

-     * 
+     * 
      * 

      * This method operates on the {@code Single} itself whereas {@link #lift} operates on {@link SingleObserver}s.
      * 

@@ -2767,7 +2767,7 @@ public final  Maybe concatMapMaybe(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -2794,7 +2794,7 @@ public final Flowable concatWith(@NonNull SingleSource other) {
      * Delays the emission of the success signal from the current {@code Single} by the specified amount.
      * An error signal will not be delayed.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code delay} operates by default on the {@code computation} {@link Scheduler}.

@@ -2817,7 +2817,7 @@ public final Single delay(long time, @NonNull TimeUnit unit) {
     /**
      * Delays the emission of the success or error signal from the current {@code Single} by the specified amount.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code delay} operates by default on the {@code computation} {@link Scheduler}.

@@ -2841,7 +2841,7 @@ public final Single delay(long time, @NonNull TimeUnit unit, boolean delayErr
      * Delays the emission of the success signal from the current {@code Single} by the specified amount.
      * An error signal will not be delayed.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
you specify the {@link Scheduler} where the non-blocking wait and emission happens

@@ -2867,7 +2867,7 @@ public final Single delay(long time, @NonNull TimeUnit unit, @NonNull Schedul
     /**
      * Delays the emission of the success or error signal from the current {@code Single} by the specified amount.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
you specify the {@link Scheduler} where the non-blocking wait and emission happens

@@ -3089,7 +3089,7 @@ public final Single delaySubscription(long time, @NonNull TimeUnit unit, @Non
     /**
      * Calls the specified consumer with the success item after this item has been emitted to the downstream.
      * 

-     * 
+     * 
      * 

      * Note that the {@code doAfterSuccess} action is shared between subscriptions and as such
      * should be thread-safe.
@@ -3114,7 +3114,7 @@ public final Single doAfterSuccess(@NonNull Consumer onAfterSucces
     /**
      * Registers an {@link Action} to be called after this {@code Single} invokes either {@code onSuccess} or {@code onError}.
      * 

-     * 
+     * 
      * 

      * Note that the {@code doAfterTerminate} action is shared between subscriptions and as such
      * should be thread-safe.

@@ -3149,7 +3149,7 @@ public final Single doAfterTerminate(@NonNull Action onAfterTerminate) {
      * 
Note that the {@code onFinally} action is shared between subscriptions and as such
      * should be thread-safe.
      * 

-     * 
+     * 
      * 

      * 

      *  
Scheduler:

@@ -3201,7 +3201,7 @@ public final Single doOnLifecycle(@NonNull Consumer onSub
      * Calls the shared consumer with the {@link Disposable} sent through the {@code onSubscribe} for each
      * {@link SingleObserver} that subscribes to the current {@code Single}.
      * 

-     * 
+     * 
      * 

      * 

      * 
Scheduler:

@@ -3224,7 +3224,7 @@ public final Single doOnSubscribe(@NonNull Consumer onSub
      * Returns a {@code Single} instance that calls the given {@code onTerminate} callback
      * just before this {@code Single} completes normally or with an exception.
      * 

-     * 
+     * 
      * 

      * This differs from {@code doAfterTerminate} in that this happens before the {@code onSuccess} or
      * {@code onError} notification.
@@ -3252,7 +3252,7 @@ public final Single doOnTerminate(@NonNull Action onTerminate) {
      * Calls the shared consumer with the success value sent via {@code onSuccess} for each
      * {@link SingleObserver} that subscribes to the current {@code Single}.
      * 

-     * 
+     * 
      * 

      * 

      * 
Scheduler:

@@ -3297,7 +3297,7 @@ public final Single doOnEvent(@NonNull BiConsumer<@Nullable ? super T, @Nulla
      * Calls the shared consumer with the error sent via {@code onError} for each
      * {@link SingleObserver} that subscribes to the current {@code Single}.
      * 

-     * 
+     * 
      * 

      * 

      * 
Scheduler:

@@ -3320,7 +3320,7 @@ public final Single doOnError(@NonNull Consumer onError) {
      * Calls the shared {@link Action} if a {@link SingleObserver} subscribed to the current {@code Single}
      * disposes the common {@link Disposable} it received via {@code onSubscribe}.
      * 

-     * 
+     * 
      * 

      * 

      * 
Scheduler:

@@ -3343,7 +3343,7 @@ public final Single doOnDispose(@NonNull Action onDispose) {
      * Filters the success item of the {@code Single} via a predicate function and emitting it if the predicate
      * returns {@code true}, completing otherwise.
      * 

-     * 
+     * 
      * 

      *  
Scheduler:

      *  
{@code filter} does not operate by default on a particular {@link Scheduler}.

@@ -3369,7 +3369,7 @@ public final Maybe filter(@NonNull Predicate predicate) {
      * Returns a {@code Single} that is based on applying a specified function to the item emitted by the current {@code Single},
      * where that function returns a {@link SingleSource}.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code flatMap} does not operate by default on a particular {@link Scheduler}.

@@ -3485,7 +3485,7 @@ public final  Maybe flatMapMaybe(@NonNull Function
-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer
@@ -3574,7 +3574,7 @@ public final  Flowable flattenAsFlowable(@NonNull Function
-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code flatMapObservable} does not operate by default on a particular {@link Scheduler}.

@@ -3901,7 +3901,7 @@ public final  Single lift(@NonNull SingleOperator
      * Returns a {@code Single} that applies a specified function to the item emitted by the current {@code Single} and
      * emits the result of this function application.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code map} does not operate by default on a particular {@link Scheduler}.

@@ -3926,7 +3926,7 @@ public final  Single lift(@NonNull SingleOperator
      * Maps the signal types of this {@code Single} into a {@link Notification} of the same kind
      * and emits it as a single success value to downstream.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code materialize} does not operate by default on a particular {@link Scheduler}.

@@ -3994,7 +3994,7 @@ public final Single contains(@NonNull Object item, @NonNull BiPredicate
     /**
      * Flattens this {@code Single} and another {@link SingleSource} into one {@link Flowable}, without any transformation.
      * 

-     * 
+     * 
      * 

      * You can combine items emitted by multiple {@code SingleSource}s so that they appear as one {@code Flowable}, by using
      * the {@code mergeWith} method.
@@ -4048,7 +4048,7 @@ public final  Maybe ofType(@NonNull Class clazz) {
      * Signals the success item or the terminal signals of the current {@code Single} on the specified {@link Scheduler},
      * asynchronously.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
you specify which {@code Scheduler} this operator will use.

@@ -4074,7 +4074,7 @@ public final Single observeOn(@NonNull Scheduler scheduler) {
      * Ends the flow with a success item returned by a function for the {@link Throwable} error signaled by the current
      * {@code Single} instead of signaling the error via {@code onError}.
      * 

-     * 
+     * 
      * 

      * By default, when a {@code Single} encounters an error that prevents it from emitting the expected item to its
      * subscriber, the {@code Single} invokes its subscriber's {@link SingleObserver#onError} method, and then quits
@@ -4108,7 +4108,7 @@ public final Single onErrorReturn(@NonNull Function i
     /**
      * Signals the specified value as success in case the current {@code Single} signals an error.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code onErrorReturnItem} does not operate by default on a particular {@link Scheduler}.

@@ -4209,7 +4209,7 @@ public final Maybe onErrorComplete(@NonNull Predicate pred
      * Resumes the flow with a {@link SingleSource} returned for the failure {@link Throwable} of the current {@code Single} by a
      * function instead of signaling the error via {@code onError}.
      * 

-     * 
+     * 
      * 

      * By default, when a {@code Single} encounters an error that prevents it from emitting the expected item to
      * its {@link SingleObserver}, the {@code Single} invokes its {@code SingleObserver}'s {@code onError} method, and then quits
@@ -4267,7 +4267,7 @@ public final Single onTerminateDetach() {
     /**
      * Repeatedly re-subscribes to the current {@code Single} and emits each success value as a {@link Flowable} sequence.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -4288,7 +4288,7 @@ public final Flowable repeat() {
     /**
      * Re-subscribes to the current {@code Single} at most the given number of times and emits each success value as a {@link Flowable} sequence.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -4313,7 +4313,7 @@ public final Flowable repeat(long times) {
      * the {@link Publisher} returned by the handler function signals a value in response to a
      * value signaled through the {@link Flowable} the handler receives.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.
@@ -4341,7 +4341,7 @@ public final Flowable repeatWhen(@NonNull Function,
      * Re-subscribes to the current {@code Single} until the given {@link BooleanSupplier} returns {@code true}
      * and emits the success items as a {@link Flowable} sequence.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -4867,7 +4867,7 @@ public final void subscribe(@NonNull SingleObserver observer) {
     /**
      * Asynchronously subscribes {@link SingleObserver}s to this {@code Single} on the specified {@link Scheduler}.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
You specify which {@code Scheduler} this operator will use.

@@ -5308,7 +5308,7 @@ private Single timeout0(final long timeout, final TimeUnit unit, final Schedu
     /**
      * Calls the specified converter function during assembly time and returns its resulting value.
      * 

-     * 
+     * 
      * 

      * This allows fluent conversion to any other type.
      * 

@@ -5351,7 +5351,7 @@ public final Completable ignoreElement() {
     /**
      * Converts this {@code Single} into a {@link Flowable}.
      * 

-     * 
+     * 
      * 

      *  
Backpressure:

      *  
The returned {@code Flowable} honors the backpressure of the downstream consumer.

@@ -5376,7 +5376,7 @@ public final Flowable toFlowable() {
     /**
      * Returns a {@link Future} representing the single value emitted by this {@code Single}.
      * 

-     * 
+     * 
      * 

      * Cancelling the {@code Future} will cancel the subscription to the current {@code Single}.
      * 

@@ -5397,7 +5397,7 @@ public final Future toFuture() {
     /**
      * Converts this {@code Single} into a {@link Maybe}.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code toMaybe} does not operate by default on a particular {@link Scheduler}.

@@ -5418,7 +5418,7 @@ public final Maybe toMaybe() {
     /**
      * Converts this {@code Single} into an {@link Observable}.
      * 

-     * 
+     * 
      * 

      * 
Scheduler:

      * 
{@code toObservable} does not operate by default on a particular {@link Scheduler}.

diff --git a/src/main/java/io/reactivex/rxjava3/flowables/ConnectableFlowable.java b/src/main/java/io/reactivex/rxjava3/flowables/ConnectableFlowable.java
index 3e80c68ced..041fc3bd1b 100644
--- a/src/main/java/io/reactivex/rxjava3/flowables/ConnectableFlowable.java
+++ b/src/main/java/io/reactivex/rxjava3/flowables/ConnectableFlowable.java
@@ -34,7 +34,7 @@
  * can wait for all intended {@link Subscriber}s to {@link Flowable#subscribe} to the {@code Flowable}
  * before the {@code Flowable} begins emitting items.
  * 

- * 
+ * 
  * 

  * When the upstream terminates, the {@code ConnectableFlowable} remains in this terminated state and,
  * depending on the actual underlying implementation, relays cached events to late {@link Subscriber}s.
diff --git a/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableMostRecent.java b/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableMostRecent.java
index bfd206eea9..d679dd937f 100644
--- a/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableMostRecent.java
+++ b/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableMostRecent.java
@@ -23,7 +23,7 @@
  * Returns an Iterable that always returns the item most recently emitted by an Observable, or a
  * seed value if no item has yet been emitted.
  * 

- * 
+ * 
  *
  * @param  the value type
  */
diff --git a/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableNext.java b/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableNext.java
index 6972bcc777..b8e79eda54 100644
--- a/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableNext.java
+++ b/src/main/java/io/reactivex/rxjava3/internal/operators/flowable/BlockingFlowableNext.java
@@ -27,7 +27,7 @@
 /**
  * Returns an Iterable that blocks until the Observable emits another item, then returns that item.
  * 

- * 
+ * 
  *
  * @param  the value type
  */
diff --git a/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableMostRecent.java b/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableMostRecent.java
index 1332351cac..75e8966ca9 100644
--- a/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableMostRecent.java
+++ b/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableMostRecent.java
@@ -23,7 +23,7 @@
  * Returns an Iterable that always returns the item most recently emitted by an Observable, or a
  * seed value if no item has yet been emitted.
  * 

- * 
+ * 
  * 
  * @param  the value type
  */
diff --git a/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableNext.java b/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableNext.java
index 53aed40999..3ebeb0e1f0 100644
--- a/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableNext.java
+++ b/src/main/java/io/reactivex/rxjava3/internal/operators/observable/BlockingObservableNext.java
@@ -25,7 +25,7 @@
 /**
  * Returns an Iterable that blocks until the Observable emits another item, then returns that item.
  * 

- * 
+ * 
  * 
  * @param  the value type
  */
diff --git a/src/main/java/io/reactivex/rxjava3/internal/operators/single/SingleFlatMapPublisher.java b/src/main/java/io/reactivex/rxjava3/internal/operators/single/SingleFlatMapPublisher.java
index c89913791d..e453f28b68 100644
--- a/src/main/java/io/reactivex/rxjava3/internal/operators/single/SingleFlatMapPublisher.java
+++ b/src/main/java/io/reactivex/rxjava3/internal/operators/single/SingleFlatMapPublisher.java
@@ -28,7 +28,7 @@
  * A Flowable that emits items based on applying a specified function to the item emitted by the
  * source Single, where that function returns a Publisher.
  * 

- * 
+ * 
  * 

  *  
Backpressure:

  *  
The returned {@code Flowable} honors the backpressure of the downstream consumer
diff --git a/src/main/java/io/reactivex/rxjava3/observables/ConnectableObservable.java b/src/main/java/io/reactivex/rxjava3/observables/ConnectableObservable.java
index 2221ac62b0..107971ca88 100644
--- a/src/main/java/io/reactivex/rxjava3/observables/ConnectableObservable.java
+++ b/src/main/java/io/reactivex/rxjava3/observables/ConnectableObservable.java
@@ -32,7 +32,7 @@
  * can wait for all intended {@link Observer}s to {@link Observable#subscribe} to the {@code Observable}
  * before the {@code Observable} begins emitting items.
  * 

- * 
+ * 
  * 

  * When the upstream terminates, the {@code ConnectableObservable} remains in this terminated state and,
  * depending on the actual underlying implementation, relays cached events to late {@link Observer}s.
diff --git a/src/main/java/io/reactivex/rxjava3/subjects/BehaviorSubject.java b/src/main/java/io/reactivex/rxjava3/subjects/BehaviorSubject.java
index 61cf92cba3..ce89f7b856 100644
--- a/src/main/java/io/reactivex/rxjava3/subjects/BehaviorSubject.java
+++ b/src/main/java/io/reactivex/rxjava3/subjects/BehaviorSubject.java
@@ -28,7 +28,7 @@
  * Subject that emits the most recent item it has observed and all subsequent observed items to each subscribed
  * {@link Observer}.
  * 

- * 
+ * 
  * 

  * This subject does not have a public constructor by design; a new empty instance of this
  * {@code BehaviorSubject} can be created via the {@link #create()} method and