clean up javadoc

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

solr/core/src/java/org/apache/solr/cloud/AssignShard.java

@@ -35,11 +35,8 @@ public class AssignShard {
    * Assign a new unique id up to slices count - then add replicas evenly.
    * 
    * @param collection
-   * 
-   * @param slices
+   * @param state
    * @return
-   * @throws InterruptedException
-   * @throws KeeperException
    */
   public static String assignShard(String collection, CloudState state) {
 

solr/core/src/java/org/apache/solr/cloud/LeaderElector.java

@@ -199,7 +199,6 @@ public  class LeaderElector {
    * watch the next lowest numbered node.
    * 
    * @param context
-   * @param SolrCore - optional - sometimes null
    * @return sequential node number
    * @throws KeeperException
    * @throws InterruptedException
@@ -256,8 +255,7 @@ public  class LeaderElector {
   /**
    * Set up any ZooKeeper nodes needed for leader election.
    * 
-   * @param shardId
-   * @param collection
+   * @param context
    * @throws InterruptedException
    * @throws KeeperException
    */

solr/core/src/java/org/apache/solr/cloud/ZkController.java

@@ -130,16 +130,15 @@ public final class ZkController {
     zkServer.stop();
   }
 
-
   /**
-   * @param coreContainer if null, recovery will not be enabled
+   * @param cc if null, recovery will not be enabled
    * @param zkServerAddress
    * @param zkClientTimeout
    * @param zkClientConnectTimeout
    * @param localHost
    * @param locaHostPort
    * @param localHostContext
-   * @param numShards 
+   * @param registerOnReconnect
    * @throws InterruptedException
    * @throws TimeoutException
    * @throws IOException
@@ -437,13 +436,14 @@ public final class ZkController {
   }
 
 
+
   /**
    * Register shard with ZooKeeper.
    * 
    * @param coreName
-   * @param cloudDesc
-   * @return
-   * @throws Exception 
+   * @param desc
+   * @return the shardId for the SolrCore
+   * @throws Exception
    */
   public String register(String coreName, final CoreDescriptor desc) throws Exception {  
     return register(coreName, desc, false);
@@ -456,7 +456,7 @@ public final class ZkController {
    * @param coreName
    * @param desc
    * @param recoverReloadedCores
-   * @return
+   * @return the shardId for the SolrCore
    * @throws Exception
    */
   public String register(String coreName, final CoreDescriptor desc, boolean recoverReloadedCores) throws Exception {