[HBASE-15497] Incorrect javadoc for atomicity guarantee of Increment and Append

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.0.0
• Fix Version/s: 1.4.0, 1.3.2, 2.0.0-alpha-3, 2.0.0, 1.2.7
• Component/s: documentation
• Hadoop Flags: Reviewed
• Assignee: Jianwei Cui
• Reporter: Jianwei Cui
• Created: 21/Mar/16 13:10
• Updated: 21/Mar/18 22:12
• Resolved: 04/Sep/17 08:33

Description

At the front of Increment.java file, there is comment about read atomicity:

 * This operation does not appear atomic to readers.  Increments are done
 * under a single row lock, so write operations to a row are synchronized, but
 * readers do not take row locks so get and scan operations can see this
 * operation partially completed.

It seems this comment is not true after MVCC integrated HBASE-4583. Currently, the readers can be guaranteed to read the whole result of Increment if I am not wrong. Similar comments also exist in Append.java, Table#append(...) and Table#increment(...)