diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
index 9f2084c256..160f7f4b5e 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
@@ -594,26 +594,29 @@ public interface Admin extends Abortable, Closeable {
boolean isTableAvailable(TableName tableName, byte[][] splitKeys) throws IOException;
/**
- * Get the status of alter command - indicates how many regions have received the updated schema
- * Asynchronous operation.
+ * Get the status of an alter (a.k.a modify) command - indicates how
+ * many regions have received the updated schema Asynchronous operation.
*
* @param tableName TableName instance
* @return Pair indicating the number of regions updated Pair.getFirst() is the regions that are
* yet to be updated Pair.getSecond() is the total number of regions of the table
* @throws IOException if a remote or network exception occurs
+ * @deprecated Since 2.0.0. Will be removed in 3.0.0. No longer needed now you get a Future
+ * on an operation.
*/
+ @Deprecated
Pair getAlterStatus(final TableName tableName) throws IOException;
/**
- * Get the status of alter command - indicates how many regions have received the updated schema
- * Asynchronous operation.
+ * Get the status of alter (a.k.a modify) command - indicates how many
+ * regions have received the updated schema Asynchronous operation.
*
* @param tableName name of the table to get the status of
* @return Pair indicating the number of regions updated Pair.getFirst() is the regions that are
* yet to be updated Pair.getSecond() is the total number of regions of the table
* @throws IOException if a remote or network exception occurs
- * @deprecated Since 2.0.0. Will be removed in 3.0.0. Use {@link #getAlterStatus(TableName)}
- * instead.
+ * @deprecated Since 2.0.0. Will be removed in 3.0.0. No longer needed now you get a Future
+ * on an operation.
*/
@Deprecated
Pair getAlterStatus(final byte[] tableName) throws IOException;