2.x: Add a sentence to documentation of take() operator.

[sadegh]

#5716

[codecov]

Codecov Report

Merging #5718 into 2.x will increase coverage by 0.03%.
The diff coverage is n/a.

@@             Coverage Diff              @@
##                2.x    #5718      +/-   ##
============================================
+ Coverage     96.23%   96.27%   +0.03%     
+ Complexity     5822     5821       -1     
============================================
  Files           634      634              
  Lines         41604    41604              
  Branches       5761     5761              
============================================
+ Hits          40039    40054      +15     
- Misses          624      625       +1     
+ Partials        941      925      -16

Impacted Files	Coverage Δ	Complexity Δ
src/main/java/io/reactivex/Flowable.java	100% <ø> (ø)	525 <0> (ø)	⬇️
src/main/java/io/reactivex/Observable.java	100% <ø> (ø)	508 <0> (ø)	⬇️
...ex/internal/operators/flowable/FlowableCreate.java	90% <0%> (-7.42%)	6% <0%> (ø)
.../io/reactivex/internal/schedulers/IoScheduler.java	92.47% <0%> (-2.16%)	9% <0%> (ø)
...rnal/operators/flowable/FlowableFlatMapSingle.java	95.65% <0%> (-1.64%)	2% <0%> (ø)
...rnal/subscriptions/DeferredScalarSubscription.java	98.46% <0%> (-1.54%)	28% <0%> (-1%)
...a/io/reactivex/internal/util/QueueDrainHelper.java	60.28% <0%> (-1.42%)	32% <0%> (-1%)
...ain/java/io/reactivex/subjects/UnicastSubject.java	97.51% <0%> (-1.25%)	64% <0%> (-1%)
...ava/io/reactivex/processors/BehaviorProcessor.java	90.26% <0%> (-0.89%)	61% <0%> (-1%)
...nternal/operators/observable/ObservableCreate.java	97.43% <0%> (-0.86%)	2% <0%> (ø)
... and 29 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update da38036...7299fe3. Read the comment docs.

[akarnokd]

A <p> would cleanly separate the first sentence and the rest of the Javadoc. Also the wording could use some refinement:

<p>
If time runs out before the {@code Flowable} completes normally, the {@code onComplete} 
event will be signaled on the default {@code computation} {@link Scheduler}.

[akarnokd]

<p>
If time runs out before the {@code Flowable} completes normally, the {@code onComplete} 
event will be signaled on the provided {@link Scheduler}.

[akarnokd]

<p>
If time runs out before the {@code Observable} completes normally, the {@code onComplete} 
event will be signaled on the default {@code computation} {@link Scheduler}.

[akarnokd]

<p>
If time runs out before the {@code Flowable} completes normally, the {@code onComplete} 
event will be signaled on the provided {@link Scheduler}.

[vanniktech]

Agreeing with david