Skip to content
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: javadoc: fix wording of some operators, remove @throws implications #4839

Merged
merged 2 commits into from
Nov 11, 2016

Conversation

akarnokd
Copy link
Member

This PR fixes some javadoc mistakes with operators such as single, first, last and co and removes @throws tags from operators since those don't throw it when the method is invoked.

@akarnokd akarnokd added this to the 2.0 backlog milestone Nov 11, 2016
@codecov-io
Copy link

codecov-io commented Nov 11, 2016

Current coverage is 95.70% (diff: 100%)

Merging #4839 into 2.x will decrease coverage by 0.08%

@@                2.x      #4839   diff @@
==========================================
  Files           580        580          
  Lines         37174      37174          
  Methods           0          0          
  Messages          0          0          
  Branches       5600       5600          
==========================================
- Hits          35610      35577    -33   
- Misses          644        660    +16   
- Partials        920        937    +17   

Powered by Codecov. Last update 36dde84...8291068

@@ -7746,7 +7746,7 @@ public final void blockingSubscribe(Subscriber<? super T> subscriber) {
}

/**
* Returns a Flowable that emits the item found at a specified index in a sequence of emissions from a
* Returns a Flowable that emits the item found at a specified index in a sequence of emissions from
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Revert this one?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually or use "this Flowable" like the others

@@ -11344,6 +11328,7 @@ public final void subscribe(Observer<? super T> observer) {
* within time windows defined by the timeout selectors
* @throws NullPointerException
* if {@code itemTimeoutIndicator} is null
* if {@code other} is null
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You might want to look at the rendered Javadoc here. I'm betting these get smashed together with only a single space. Might be better to switch to {@code itemTimeoutIndicator} or {@code other} is null.

@akarnokd
Copy link
Member Author

Thanks @JakeWharton, fixed those problems.

@akarnokd akarnokd merged commit ff66abc into ReactiveX:2.x Nov 11, 2016
@akarnokd akarnokd deleted the JavadocFix11_11 branch November 11, 2016 23:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants