-
Notifications
You must be signed in to change notification settings - Fork 3.4k
HBASE-22725 Remove all remaining javadoc warnings #463
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
Conversation
|
💔 -1 overall
This message was automatically generated. |
HorizonNet
left a comment
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.
LGTM overall, but left a few suggestions for improvements.
| * @return either Include {@link ReturnCode} or Skip {@link ReturnCode} | ||
| * @param loc the destination of data | ||
| * @param heapSizeOfRow the data size | ||
| * @return either Include {@link RequestController.ReturnCode} or Skip |
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: "skip" (lower 's').
| /** | ||
| * @param tableName the name of the table | ||
| * @param startKey the start key of the region | ||
| * @param stopKey the start key of the region |
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 stop key of the region.
| * @param stopKey the start key of the region | ||
| * @param callingMethod the name of the calling method probably a test method | ||
| * @param conf the configuration to use | ||
| * @param isReadOnly true if the table is read only, false otherwise |
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.
Suggestion: Use {@code true} and {@code false} instead.
| * @throws IOException if an IO problem is encountered | ||
| * @return A region on which you must call {@link HBaseTestingUtility#closeRegionAndWAL(HRegion)} | ||
| * when done. | ||
| * @deprecated since 2.0.0 and will be removed in 3.0.0. Use |
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 indentation is wrong.
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.
This should also fix the Checkstyle violation.
| * @deprecated since 2.0.0 and will be removed in 3.0.0. Use | ||
| * {@link HBaseTestingUtility#createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...)} | ||
| * instead. | ||
| * @see HBaseTestingUtility#createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...) |
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.
Ditto.
| * {@link HBaseTestingUtility#createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...)} | ||
| * instead. | ||
| * @see HBaseTestingUtility#createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...) | ||
| * @see <a href="https://issues.apache.org/jira/browse/HBASE-13893">HBASE-13893</a> |
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.
Ditto.
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
@HorizonNet |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
💔 -1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
saintstack
left a comment
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.
Skimmed. Looks good to me. What you think @HorizonNet ?
| * Use this method filling the backing data source used by {@link #get(RpcController, GetRequest)} | ||
| * @param regionName | ||
| * @param row | ||
| * @param r |
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.
In future, could just purge params that do not have description.
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.
You mean inside test code, right?
Removed all javadoc warnings and now there is no javadoc warning anymore