Fix Javadoc warnings

Change-Id: I857d8bd7d9fc0862f3c0097d3e65cbedfb997b0f

@@ -44,6 +44,7 @@ public class Interface {
      * @param connectPoint the connect point this interface is mapped to
      * @param ipAddresses the IP addresses for the interface
      * @param macAddress the MAC address of the interface
+     * @param vlan VLAN identifier
      */
     public Interface(ConnectPoint connectPoint,
                      Set<InterfaceIpAddress> ipAddresses,

@@ -144,6 +144,8 @@ public interface OpenFlowSwitch {
 
     /**
      * Identifies the channel used to communicate with the switch.
+     *
+     * @return string representation of the connection to the device
      */
     public String channelId();
 

@@ -80,6 +80,7 @@ public class TopologyWebResource extends AbstractWebResource {
     /**
      * Gets details for a topology cluster for a REST GET operation.
      *
+     * @param clusterId id of the cluster to query
      * @return topology cluster details
      */
     @GET
@@ -101,6 +102,7 @@ public class TopologyWebResource extends AbstractWebResource {
     /**
      * Gets devices for a topology cluster for a REST GET operation.
      *
+     * @param clusterId id of the cluster to query
      * @return topology cluster devices
      */
     @GET
@@ -131,6 +133,7 @@ public class TopologyWebResource extends AbstractWebResource {
     /**
      * Gets links for a topology cluster for a REST GET operation.
      *
+     * @param clusterId id of the cluster to query
      * @return topology cluster links
      */
     @GET
@@ -181,6 +184,8 @@ public class TopologyWebResource extends AbstractWebResource {
     /**
      * Gets the broadcast flag of a connect point for a REST GET operation.
      *
+     * @param connectPointString string representation of the connect point to query.
+     *                           Format is deviceid:portnumber
      * @return JSON representation of true if the connect point is broadcast,
      *         false otherwise
      */
@@ -202,6 +207,8 @@ public class TopologyWebResource extends AbstractWebResource {
     /**
      * Gets the infrastructure flag of a connect point for a REST GET operation.
      *
+     * @param connectPointString string representation of the connect point to query.
+     *                           Format is deviceid:portnumber
      * @return JSON representation of true if the connect point is broadcast,
      *         false otherwise
      */