Fixed javadoc warnings & added a few deprecations.
Change-Id: I89205b08bc5fcbfed769c489609a46d420ee227e
diff --git a/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java b/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java
index 0ad4fc6..804f05e 100644
--- a/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java
+++ b/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java
@@ -107,6 +107,8 @@
* Get Swagger UI main index page.
*
* @return 200 OK
+ * @throws IOException if unable to get index resource
+ * @throws URISyntaxException if unable to create redirect URI
*/
@GET
@Path("/")
@@ -119,6 +121,7 @@
* Get Swagger UI main index page.
*
* @return 200 OK
+ * @throws IOException if unable to get index resource
*/
@GET
@Path("index.html")
@@ -155,7 +158,9 @@
/**
* Get Swagger UI resource.
*
+ * @param resource path of the resource
* @return 200 OK
+ * @throws IOException if unable to get named resource
*/
@GET
@Path("{resource: .*}")
diff --git a/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java b/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java
index ee608b7..dd9b9fc 100644
--- a/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java
+++ b/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java
@@ -77,6 +77,7 @@
*
* @param config cluster definition
* @return 200 OK
+ * @throws IOException to signify bad request
*/
@POST
@Path("configuration")
diff --git a/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java b/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java
index 4adb6c5..468a376 100644
--- a/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java
+++ b/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java
@@ -82,7 +82,9 @@
* Sets only the properties present in the JSON request.
*
* @param component component name
+ * @param request JSON configuration
* @return 200 OK
+ * @throws IOException to signify bad request
*/
@POST
@Path("{component}")
@@ -100,7 +102,9 @@
* Clears only the properties present in the JSON request.
*
* @param component component name
+ * @param request JSON configuration
* @return 200 OK
+ * @throws IOException to signify bad request
*/
@DELETE
@Path("{component}")