-
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: Improve BehaviorSubject JavaDoc + related clarifications #5780
Conversation
Codecov Report
@@ Coverage Diff @@
## 2.x #5780 +/- ##
============================================
- Coverage 96.27% 96.21% -0.07%
- Complexity 5807 5809 +2
============================================
Files 634 634
Lines 41607 41607
Branches 5770 5770
============================================
- Hits 40057 40031 -26
- Misses 611 634 +23
- Partials 939 942 +3
Continue to review full report at Codecov.
|
* @param error the error to report | ||
* @see #getErrorHandler() | ||
* @see #setErrorHandler(Consumer) |
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.
@akarnokd
Do you think it makes sense to reference
https://github.com/ReactiveX/RxJava/wiki/What's-different-in-2.0#error-handling
here?
Is it acceptable to reference Wiki from javadoc?
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.
Updated.
@@ -337,7 +337,23 @@ public static Scheduler onComputationScheduler(@NonNull Scheduler defaultSchedul | |||
|
|||
/** | |||
* Called when an undeliverable error occurs. | |||
* <p> | |||
* Undeliverable errors are those {@code Observer.onError()} invocations that are not allowed happen to |
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.
Nit:
.. that are not allowed to happen to ...
?
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.
Updated.
This PR adds detailed behavior and feature description to the
BehaviorSubject
JavaDoc.In addition, small mistakes in the
BehaviorProcessor
JavaDoc have also been fixed and both received an extra section:Error handling
that points at the global error handler for undeliverable errors. Due to this link, theRxJavaPlugins.onError
JavaDoc has been also expanded.