Fixed javadocs warning

Author: thboileau

modules/org.restlet.ext.httpclient/src/main/java/org/restlet/ext/httpclient/HttpClientHelper.java

@@ -71,6 +71,7 @@
  * Here is the list of parameters that are supported. They should be set in the
  * Client's context before it is started:
  * <table>
+ * <caption>list of supported parameters</caption>
  * <tr>
  * <th>Parameter name</th>
  * <th>Value type</th>

modules/org.restlet.ext.jackson/src/main/java/org/restlet/ext/jackson/JacksonConverter.java

@@ -77,6 +77,7 @@ public class JacksonConverter extends ConverterHelper {
      * Creates the marshaling {@link JacksonRepresentation}.
      * 
      * @param <T>
+     *            The expected class of the representation Java object.
      * @param mediaType
      *            The target media type.
      * @param source
@@ -91,6 +92,7 @@ protected <T> JacksonRepresentation<T> create(MediaType mediaType, T source) {
      * Creates the unmarshaling {@link JacksonRepresentation}.
      * 
      * @param <T>
+     *            The expected class of the representation Java object.
      * @param source
      *            The source representation to unmarshal.
      * @param objectClass

modules/org.restlet.ext.jaxb/src/main/java/org/restlet/ext/jaxb/JaxbRepresentation.java

@@ -366,6 +366,7 @@ public String getContextPath() {
      * Returns a JAXB SAX source.
      * 
      * @return A JAXB SAX source.
+     * @throws IOException
      */
     public JAXBSource getJaxbSource() throws IOException {
         try {

modules/org.restlet.ext.jetty/src/main/java/org/restlet/ext/jetty/HttpClientHelper.java

@@ -52,6 +52,7 @@
  * that are supported. They should be set in the Client's context before it is
  * started:
  * <table>
+ * <caption>list of supported parameters</caption>
  * <tr>
  * <th>Parameter name</th>
  * <th>Value type</th>

modules/org.restlet.ext.jetty/src/main/java/org/restlet/ext/jetty/HttpsServerHelper.java

@@ -41,6 +41,7 @@
  * are supported. They should be set in the Server's context before it is
  * started:
  * <table>
+ * <caption>list of supported parameters</caption>
  * <tr>
  * <th>Parameter name</th>
  * <th>Value type</th>

modules/org.restlet.ext.jetty/src/main/java/org/restlet/ext/jetty/JettyServerHelper.java

@@ -50,6 +50,7 @@
  * Abstract Jetty web server connector. Here is the list of parameters that are
  * supported. They should be set in the Server's context before it is started:
  * <table>
+ * <caption>list of supported parameters</caption>
  * <tr>
  * <th>Parameter name</th>
  * <th>Value type</th>

modules/org.restlet.ext.json/src/main/java/org/restlet/ext/json/JsonRepresentation.java

@@ -133,8 +133,7 @@ public JsonRepresentation(Object bean) {
      * @param jsonRepresentation
      *            A source JSON representation to parse.
      */
-    public JsonRepresentation(Representation jsonRepresentation)
-            throws IOException {
+    public JsonRepresentation(Representation jsonRepresentation) {
         super((jsonRepresentation == null) ? null : jsonRepresentation
                 .getMediaType());
         this.jsonRepresentation = jsonRepresentation;

modules/org.restlet.ext.odata/src/main/java/org/restlet/ext/odata/Query.java

@@ -67,7 +67,7 @@ public class Query<T> implements Iterable<T> {
      * 
      * @author Thierry Boileau
      * 
-     * @param <T>
+     * @param <E>
      */
     private class EntryIterator<E> implements Iterator<E> {
 
@@ -237,15 +237,15 @@ public Query(Service service, String subpath, Class<T> entityClass) {
     }
 
     /**
-     * Creates a new Query<T> with the query parameter set in the URI generated
+     * Creates a new Query with the query parameter set in the URI generated
      * by the returned query.
      * 
      * @param name
      *            The string value that contains the name of the query string
      *            option to add.
      * @param value
      *            The value of the query string option.
-     * @return A new Query<T> with the query parameter set in the URI generated
+     * @return A new Query with the query parameter set in the URI generated
      *         by the returned query.
      */
     @SuppressWarnings("unchecked")
@@ -262,12 +262,12 @@ public Query<T> addParameter(String name, String value) {
     }
 
     /**
-     * Creates a new Query<T> with the query parameter set in the URI generated
+     * Creates a new Query with the query parameter set in the URI generated
      * by the returned query.
      * 
      * @param params
      *            the set of name/value pairs to add to the query string
-     * @return A new Query<T> with the query parameter set in the URI generated
+     * @return A new Query with the query parameter set in the URI generated
      *         by the returned query.
      */
     @SuppressWarnings("unchecked")
@@ -428,26 +428,26 @@ public void execute() throws Exception {
     }
 
     /**
-     * Creates a new Query<T> with the $expand option set in the URI generated
+     * Creates a new Query with the $expand option set in the URI generated
      * by the returned query.
      * 
      * @param path
      *            A string value that contains the requesting URI.
-     * @return A new Query<T> with the $expand option set in the URI generated
+     * @return A new Query with the $expand option set in the URI generated
      *         by the returned query.
      */
     public Query<T> expand(String path) {
         return addParameter("$expand", path);
     }
 
     /**
-     * Creates a new Query<T> with the $filter option set in the URI generated
+     * Creates a new Query with the $filter option set in the URI generated
      * by the returned query.
      * 
      * @param predicate
      *            A string value that contains the predicate used to filter the
      *            data.
-     * @return A new Query<T> with the $filter option set in the URI generated
+     * @return A new Query with the $filter option set in the URI generated
      *         by the returned query.
      */
     public Query<T> filter(String predicate) {
@@ -602,13 +602,13 @@ private int guessType(String targetUri) {
     }
 
     /**
-     * Creates a new Query<T> with the $inlinecount option set in the URI
+     * Creates a new Query with the $inlinecount option set in the URI
      * generated by the returned query.
      * 
      * @param inlineCount
      *            True if the total number of entities in the entity set must be
      *            returned.
-     * @return A new Query<T> with the $inlinecount option set in the URI
+     * @return A new Query with the $inlinecount option set in the URI
      *         generated by the returned query.
      */
     public Query<T> inlineCount(boolean inlineCount) {
@@ -670,26 +670,26 @@ public Iterator<T> iterator() {
     }
 
     /**
-     * Creates a new Query<T> with the $orderby option set in the URI generated
+     * Creates a new Query with the $orderby option set in the URI generated
      * by the returned query.
      * 
      * @param criteria
      *            A string value that contains the criteria used to order the
      *            results.
-     * @return A new Query<T> with the $orderby option set in the URI generated
+     * @return A new Query with the $orderby option set in the URI generated
      *         by the returned query.
      */
     public Query<T> orderBy(String criteria) {
         return addParameter("$orderby", criteria);
     }
 
     /**
-     * Creates a new Query<T> with the $select option set in the URI generated
+     * Creates a new Query with the $select option set in the URI generated
      * by the returned query.
      * 
      * @param select
      *            A string value that contains the requesting URI.
-     * @return A new Query<T> with the $select option set in the URI generated
+     * @return A new Query with the $select option set in the URI generated
      *         by the returned query.
      */
     public Query<T> select(String select) {
@@ -737,38 +737,38 @@ public void setQuery(String query) {
     }
 
     /**
-     * Creates a new Query<T> with the $skip option set in the URI generated by
+     * Creates a new Query with the $skip option set in the URI generated by
      * the returned query.
      * 
      * @param rowsCount
      *            A number of rows to skip.
-     * @return A new Query<T> with the $skip option set in the URI generated by
+     * @return A new Query with the $skip option set in the URI generated by
      *         the returned query.
      */
     public Query<T> skip(int rowsCount) {
         return addParameter("$skip", Integer.toString(rowsCount));
     }
 
     /**
-     * Creates a new Query<T> with the $skiptoken option set in the URI
+     * Creates a new Query with the $skiptoken option set in the URI
      * generated by the returned query.
      * 
      * @param token
      *            A string value that contains the requesting URI.
-     * @return A new Query<T> with the $skiptoken option set in the URI
+     * @return A new Query with the $skiptoken option set in the URI
      *         generated by the returned query.
      */
     public Query<T> skipToken(String token) {
         return addParameter("$skiptoken", token);
     }
 
     /**
-     * Creates a new Query<T> with the $top option set in the URI generated by
+     * Creates a new Query with the $top option set in the URI generated by
      * the returned query.
-     * 
+     *
      * @param rowsCount
      *            A number of rows used to limit the number of results.
-     * @return A new Query<T> with the $top option set in the URI generated by
+     * @return A new Query with the $top option set in the URI generated by
      *         the returned query.
      */
     public Query<T> top(int rowsCount) {

modules/org.restlet.ext.odata/src/main/java/org/restlet/ext/odata/Service.java

@@ -878,7 +878,7 @@ public Representation invokeComplex(String service,
      * @throws ResourceException
      *             Thrown when the service call is not successfull.
      * @throws Exception
-     *             Thrown when the value cannot be parsed.
+     *
      * @see <a
      *      href="http://msdn.microsoft.com/en-us/library/cc668788.aspx">Service
      *      Operations</a>

modules/org.restlet.ext.servlet/src/main/java/org/restlet/ext/servlet/ServerServlet.java

@@ -67,6 +67,7 @@
  * Please note that you can also combine the two first of them whereas the last
  * one is a full alternative. They are described below by order of priority:
  * <table>
+ * <caption>list of supported deployment modes</caption>
  * <tr>
  * <th>Mode</th>
  * <th>Description</th>