git commit: HBASE-12049 Help for alter command is a bit confusing (Ashish Singhi)

[mi...@apache.org]

Repository: hbase
Updated Branches:
  refs/heads/master 456e9fa7a -> 231bc9876


HBASE-12049 Help for alter command is a bit confusing (Ashish Singhi)


Project: http://git-wip-us.apache.org/repos/asf/hbase/repo
Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/231bc987
Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/231bc987
Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/231bc987

Branch: refs/heads/master
Commit: 231bc987611b4e2d9d7aa6e86a06891934b0e5b2
Parents: 456e9fa
Author: Misty Stanley-Jones <ms...@cloudera.com>
Authored: Wed Oct 1 16:23:48 2014 +1000
Committer: Misty Stanley-Jones <ms...@cloudera.com>
Committed: Wed Oct 1 16:24:02 2014 +1000

----------------------------------------------------------------------
 hbase-shell/src/main/ruby/shell/commands/alter.rb | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hbase/blob/231bc987/hbase-shell/src/main/ruby/shell/commands/alter.rb
----------------------------------------------------------------------
diff --git a/hbase-shell/src/main/ruby/shell/commands/alter.rb b/hbase-shell/src/main/ruby/shell/commands/alter.rb
index 7ef185f..18cafa8 100644
--- a/hbase-shell/src/main/ruby/shell/commands/alter.rb
+++ b/hbase-shell/src/main/ruby/shell/commands/alter.rb
@@ -22,12 +22,17 @@ module Shell
     class Alter < Command
       def help
         return <<-EOF
-Alter a table. Depending on the HBase setting ("hbase.online.schema.update.enable"),
-the table must be disabled or not to be altered (see help 'disable').
-You can add/modify/delete column families, as well as change table 
-configuration. Column families work similarly to create; column family 
-spec can either be a name string, or a dictionary with NAME attribute.
-Dictionaries are described on the main help command output.
+Alter a table. If the "hbase.online.schema.update.enable" property is set to
+false, then the table must be disabled (see help 'disable'). If the 
+"hbase.online.schema.update.enable" property is set to true, tables can be 
+altered without disabling them first. Altering enabled tables has caused problems 
+in the past, so use caution and test it before using in production. 
+
+You can use the alter command to add, 
+modify or delete column families or change table configuration options.
+Column families work in a similar way as the 'create' command. The column family
+specification can either be a name string, or a dictionary with the NAME attribute.
+Dictionaries are described in the output of the 'help' command, with no arguments.
 
 For example, to change or add the 'f1' column family in table 't1' from 
 current value to keep a maximum of 5 cell VERSIONS, do: