-
Notifications
You must be signed in to change notification settings - Fork 7.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
2.x: fix/clarify the Observable class' javadoc #5432
2.x: fix/clarify the Observable class' javadoc #5432
Conversation
* therefore accept general {@code ObservableSource}s directly and allow direct interoperation with other | ||
* Reactive-Streams implementations. | ||
* Many operators in the class accept {@code ObservableSource}(s), the base reactive interface | ||
* for such non-backpressured flows, which {@code Observable} itself extends as well. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/extends/implements
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok.
* <p> | ||
* The {@code Observable} follows the protocol | ||
* <pre><code> | ||
* onSubscribe onNext* (onError | onComplete)? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
maybe onNext(T)*
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The parameters are omitted to avoid conflict with the regexp-like pattern
* <pre><code> | ||
* Disposable d = Observable.just("Hello world!") | ||
* .delay(1, TimeUnit.SECONDS) | ||
* .subscribeWith(new DisposableObserver<String>() { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/>/>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The closing >
doesn't need escaping.
Codecov Report
@@ Coverage Diff @@
## 2.x #5432 +/- ##
============================================
+ Coverage 96.02% 96.07% +0.05%
- Complexity 5787 5801 +14
============================================
Files 631 631
Lines 41291 41291
Branches 5742 5742
============================================
+ Hits 39648 39669 +21
+ Misses 650 635 -15
+ Partials 993 987 -6
Continue to review full report at Codecov.
|
This PR rewords the javadoc of the
Observable
class a bit and adds a couple of extra clarifying sentences.