ZOOKEEPER-3197: Improve documentation in ZooKeeperServer.superSecret

Author: Colm O hEigeartaigh <coheigea@apache.org>

Reviewers: andor@apache.org

Closes #752 from coheigea/ZOOKEEPER-3197

(cherry picked from commit 36b8711ebfd7ea749d547a52ddcd7d8853931728)
Signed-off-by: Andor Molnar <andor@apache.org>

zookeeper-server/src/main/java/org/apache/zookeeper/server/ZooKeeperServer.java

@@ -110,8 +110,10 @@ public class ZooKeeperServer implements SessionExpirer, ServerStats.Provider {
     }
 
     /**
-     * This is the secret that we use to generate passwords, for the moment it
-     * is more of a sanity check.
+     * This is the secret that we use to generate passwords. For the moment,
+     * it's more of a checksum that's used in reconnection, which carries no
+     * security weight, and is treated internally as if it carries no
+     * security weight.
      */
     static final private long superSecret = 0XB3415C00L;