Fix all javadoc warnings

Change-Id: I26ba78195fd8245eeb25c29ba27cc4b11b2eb791

 /*
- * Copyright 2015 Open Networking Laboratory
+ * Copyright 2015-2016 Open Networking Laboratory
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,6 +15,6 @@
  */
 
 /**
- * OpenStack switch interface.
+ * OpenStack switch API.
  */
 package org.onosproject.openstackswitching;

@@ -13,7 +13,7 @@
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;
 
 import org.onlab.packet.ARP;
 import org.onlab.packet.Ethernet;
@@ -27,6 +27,7 @@ import org.onosproject.net.host.HostService;
 import org.onosproject.net.packet.DefaultOutboundPacket;
 import org.onosproject.net.packet.InboundPacket;
 import org.onosproject.net.packet.PacketService;
+import org.onosproject.openstackswitching.OpenstackPort;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import java.nio.ByteBuffer;

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;
 
 import org.onlab.packet.Ip4Address;
 import org.onosproject.net.DeviceId;

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.node.ArrayNode;
@@ -21,6 +21,9 @@ import com.fasterxml.jackson.databind.node.ObjectNode;
 import com.google.common.collect.Lists;
 import com.sun.jersey.api.client.Client;
 import com.sun.jersey.api.client.WebResource;
+import org.onosproject.openstackswitching.OpenstackNetwork;
+import org.onosproject.openstackswitching.OpenstackPort;
+import org.onosproject.openstackswitching.OpenstackSubnet;
 import org.onosproject.openstackswitching.web.OpenstackNetworkCodec;
 import org.onosproject.openstackswitching.web.OpenstackPortCodec;
 import org.onosproject.openstackswitching.web.OpenstackSubnetCodec;

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;
 
 import org.onosproject.core.ApplicationId;
 import org.onosproject.net.config.Config;

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;
 
 import com.google.common.collect.ImmutableSet;
 import com.google.common.collect.Lists;
@@ -50,6 +50,10 @@ import org.onosproject.net.packet.InboundPacket;
 import org.onosproject.net.packet.PacketContext;
 import org.onosproject.net.packet.PacketProcessor;
 import org.onosproject.net.packet.PacketService;
+import org.onosproject.openstackswitching.OpenstackNetwork;
+import org.onosproject.openstackswitching.OpenstackPort;
+import org.onosproject.openstackswitching.OpenstackSubnet;
+import org.onosproject.openstackswitching.OpenstackSwitchingService;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import java.util.List;

@@ -14,7 +14,7 @@
 * limitations under the License.
 */
 
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;
 
 import org.onlab.packet.Ethernet;
 import org.onlab.packet.Ip4Address;
@@ -40,6 +40,8 @@ import org.onosproject.net.flow.instructions.ExtensionTreatmentType;
 import org.onosproject.net.flowobjective.DefaultForwardingObjective;
 import org.onosproject.net.flowobjective.FlowObjectiveService;
 import org.onosproject.net.flowobjective.ForwardingObjective;
+import org.onosproject.openstackswitching.OpenstackNetwork;
+import org.onosproject.openstackswitching.OpenstackPort;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 

 /*
- * Copyright 2015 Open Networking Laboratory
+ * Copyright 2015-2016 Open Networking Laboratory
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,6 +15,6 @@
  */
 
 /**
- * OpenStack switch interface.
+ * OpenStack switch implementation.
  */
-package org.onosproject.openstackswitching;
+package org.onosproject.openstackswitching.impl;

@@ -30,7 +30,6 @@ import com.google.common.collect.Lists;
  * <p>
  * Usage Example:
  * <pre>
- * <code>
     private ListenerTracker listeners;
 
     {@code @Activate}
@@ -47,7 +46,6 @@ import com.google.common.collect.Lists;
     protected void deactivate() {
         listeners.removeListeners();
     }
- * </code>
  * </pre>
  */
 @Beta
@@ -60,6 +58,8 @@ public class ListenerTracker {
     /**
      * Adds {@link EventListener} to specified {@link ListenerService}.
      *
+     * @param <E> event
+     * @param <L> listener
      * @param service {@link ListenerService}
      * @param listener {@link EventListener}
      * @return self

@@ -31,6 +31,7 @@ public final class GuavaCollectors {
      * Returns a {@code Collector} that accumulates the input elements into a
      * new ImmutableSet.
      *
+     * @param <T> type
      * @return a {@code Collector} which collects all the input elements into a
      * {@code ImmutableSet}
      */
@@ -46,6 +47,7 @@ public final class GuavaCollectors {
      * Returns a {@code Collector} that accumulates the input elements into a
      * new ImmutableList.
      *
+     * @param <T> type
      * @return a {@code Collector} which collects all the input elements into a
      * {@code ImmutableList}, in encounter order
      */

@@ -40,6 +40,7 @@ public class UnmodifiableDeque<E> implements Deque<E> {
     /**
      * Returns an unmodifiable view of the specified Deque.
      *
+     * @param <T> type
      * @param deque underlying {@link Deque} to use.
      * @return unmodifiable view of {@code deque}
      */