Better balancer javadoc

git-svn-id: https://svn.apache.org/repos/asf/hbase/trunk@1092532 13f79535-47bb-0310-9956-ffa450edef68

src/main/java/org/apache/hadoop/hbase/ipc/HMasterInterface.java

@@ -188,7 +188,9 @@ public interface HMasterInterface extends VersionedProtocol {
    * Run the balancer.  Will run the balancer and if regions to move, it will
    * go ahead and do the reassignments.  Can NOT run for various reasons.  Check
    * logs.
-   * @return True if balancer ran, false otherwise.
+   * @return True if balancer ran and was able to tell the region servers to
+   * unassign all the regions to balance (the re-assignment itself is async),
+   * false otherwise.
    */
   public boolean balance();
 

src/main/ruby/shell/commands/balancer.rb

@@ -23,8 +23,9 @@ module Shell
     class Balancer < Command
       def help
         return <<-EOF
-Trigger the cluster balancer. Returns true if balancer ran.  Otherwise
-false (Will not run if regions in transition).
+Trigger the cluster balancer. Returns true if balancer ran and was able to
+tell the region servers to unassign all the regions to balance  (the re-assignment itself is async). 
+Otherwise false (Will not run if regions in transition).
 EOF
       end