[HBASE-15447] Improve javadocs description for Delete methods

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 2.0.0
• Component/s: API, documentation
• Hadoop Flags: Reviewed
• Assignee: Wellington Chevreuil
• Reporter: Wellington Chevreuil
• Created: 11/Mar/16 18:16
• Updated: 23/Mar/16 00:10
• Resolved: 22/Mar/16 19:52

Description

Current javadoc for Delete operation is a bit confusing. Even though initial section does describe the proper behaviour, where calling delete without specifying timestamp will only delete records from now to the past, this is not as clear in the method specific description

public Delete(byte[] row)
Create a Delete operation for the specified row.
If no further operations are done, this will delete everything associated with the specified row (all versions of all columns in all families).

Parameters:
row - row key

The description can lead to the conclusion that all versions will be deleted. But that's not true if a row has a future timestamp. Although this is a very unusual scenario (having a future timestamp), it should still be clarified.