Cleaning up javadocs.

Change-Id: I67a0600fc80f9d7b0859f2e0e7634579cab6cfbf

@@ -60,6 +60,7 @@ public class CordVtnArpProxy {
      *
      *
      * @param appId application id
      * @param appId application id
      * @param packetService packet service
      * @param packetService packet service
+     * @param hostService host service reference
      */
      */
     public CordVtnArpProxy(ApplicationId appId, PacketService packetService, HostService hostService) {
     public CordVtnArpProxy(ApplicationId appId, PacketService packetService, HostService hostService) {
         this.appId = appId;
         this.appId = appId;

@@ -96,6 +96,7 @@ public class OpenstackSwitchingRulePopulator {
     /**
     /**
      * Populates flow rules for the VM created.
      * Populates flow rules for the VM created.
      *
      *
+     * @param doNotPushFlow true to suppress push of initial flows
      * @param device device to populate rules to
      * @param device device to populate rules to
      * @param port port for the VM created
      * @param port port for the VM created
      */
      */
@@ -271,6 +272,7 @@ public class OpenstackSwitchingRulePopulator {
     /**
     /**
      * Remove flows rules for the removed VM.
      * Remove flows rules for the removed VM.
      *
      *
+     * @param doNotPushFlows true to suppress push of initial flows
      * @param removedPort removedport info
      * @param removedPort removedport info
      * @param openstackPortInfoMap openstackPortInfoMap
      * @param openstackPortInfoMap openstackPortInfoMap
      */
      */

@@ -35,7 +35,7 @@ public abstract class ConsistentMapBuilder<K, V>
     /**
     /**
      * Clears map contents when the owning application is uninstalled.
      * Clears map contents when the owning application is uninstalled.
      *
      *
-     * return this builder
+     * @return this builder
      */
      */
     public ConsistentMapBuilder<K, V> withPurgeOnUninstall() {
     public ConsistentMapBuilder<K, V> withPurgeOnUninstall() {
         purgeOnUninstall = true;
         purgeOnUninstall = true;

@@ -34,7 +34,7 @@ public abstract class DistributedSetBuilder<E> extends DistributedPrimitiveBuild
     /**
     /**
      * Enables clearing set contents when the owning application is uninstalled.
      * Enables clearing set contents when the owning application is uninstalled.
      *
      *
-     * return this builder
+     * @return this builder
      */
      */
     public DistributedSetBuilder<E> withPurgeOnUninstall() {
     public DistributedSetBuilder<E> withPurgeOnUninstall() {
         purgeOnUninstall = true;
         purgeOnUninstall = true;

@@ -76,6 +76,7 @@ final class ResourceDeviceListener implements DeviceListener {
      * Creates an instance with the specified ResourceAdminService and ExecutorService.
      * Creates an instance with the specified ResourceAdminService and ExecutorService.
      *
      *
      * @param adminService instance invoked to register resources
      * @param adminService instance invoked to register resources
+     * @param resourceService {@link ResourceService} to be used
      * @param deviceService {@link DeviceService} to be used
      * @param deviceService {@link DeviceService} to be used
      * @param driverService {@link DriverService} to be used
      * @param driverService {@link DriverService} to be used
      * @param netcfgService {@link NetworkConfigService} to be used.
      * @param netcfgService {@link NetworkConfigService} to be used.

@@ -36,7 +36,9 @@ public class TransactionCoordinator {
 
 
     /**
     /**
      * Commits a transaction.
      * Commits a transaction.
+     *
      * @param transactionId           transaction
      * @param transactionId           transaction
+     * @param transactionParticipants set of transaction participants
      * @return future for commit result
      * @return future for commit result
      */
      */
     CompletableFuture<Void> commit(TransactionId transactionId, Set<TransactionParticipant> transactionParticipants) {
     CompletableFuture<Void> commit(TransactionId transactionId, Set<TransactionParticipant> transactionParticipants) {

@@ -107,11 +107,11 @@ public class NewAdaptiveFlowStatsCollector {
     /**
     /**
      * Creates a new adaptive collector for the given switch and default cal_and_poll frequency.
      * Creates a new adaptive collector for the given switch and default cal_and_poll frequency.
      *
      *
+     * @param driverService driver service reference
      * @param sw            switch to pull
      * @param sw            switch to pull
      * @param pollInterval  cal and immediate poll frequency in seconds
      * @param pollInterval  cal and immediate poll frequency in seconds
      */
      */
-    NewAdaptiveFlowStatsCollector(
-            DriverService driverService, OpenFlowSwitch sw, int pollInterval) {
+    NewAdaptiveFlowStatsCollector(DriverService driverService, OpenFlowSwitch sw, int pollInterval) {
         this.driverService = driverService;
         this.driverService = driverService;
         this.sw = sw;
         this.sw = sw;
         initMemberVars(pollInterval);
         initMemberVars(pollInterval);

@@ -42,8 +42,8 @@ final class RestDeviceProviderUtilities {
      * connection with any SSL protected device that ONOS has an interaction with.
      * connection with any SSL protected device that ONOS has an interaction with.
      * Needs addressing for secutirty purposes.
      * Needs addressing for secutirty purposes.
      *
      *
-     * @throws NoSuchAlgorithmException
-     * @throws KeyManagementException
+     * @throws NoSuchAlgorithmException if algorithm specified is not available
+     * @throws KeyManagementException if unable to use the key
      */
      */
     //FIXME redo for security purposes.
     //FIXME redo for security purposes.
     protected static void enableSslCert() throws NoSuchAlgorithmException, KeyManagementException {
     protected static void enableSslCert() throws NoSuchAlgorithmException, KeyManagementException {