[ 
https://issues.apache.org/jira/browse/HBASE-1176?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12701818#action_12701818
 ] 

stack commented on HBASE-1176:
------------------------------

Looks great Evgeny.

One thing, please add period after first sentence otherwise "Creates a new 
table" and "Synchronous operation" are run together in javadoc (try it and see 
yourself "ant javadoc").  If you add period, the method synopsis will be 
"Creates a new table" rather than "Creates a new table Synchronous operation"


> Javadocs in HBA should be clear about which functions are asynchronous and 
> which are synchronous
> ------------------------------------------------------------------------------------------------
>
>                 Key: HBASE-1176
>                 URL: https://issues.apache.org/jira/browse/HBASE-1176
>             Project: Hadoop HBase
>          Issue Type: Improvement
>          Components: client
>    Affects Versions: 0.19.0
>            Reporter: Jonathan Gray
>            Assignee: Evgeny Ryabitskiy
>            Priority: Minor
>             Fix For: 0.20.0
>
>         Attachments: HBASE-1176.patch
>
>
> Since we don't name all of our functions as sync/async, we should at least be 
> explicit in javadoc about the behavior of each.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to