Enable werror for javadoc and fix javadoc issues

smack-extensions/src/main/java/org/jivesoftware/smackx/bob/BoBData.java

@@ -42,9 +42,9 @@ public class BoBData {
     /**
      * BoB data constructor.
      *
-     * @param type
-     * @param content
-     * @param maxAge
+     * @param type TODO javadoc me please
+     * @param content TODO javadoc me please
+     * @param maxAge TODO javadoc me please
      */
     public BoBData(String type, byte[] content, int maxAge) {
         this.type = type;

smack-extensions/src/main/java/org/jivesoftware/smackx/bob/BoBHash.java

@@ -35,8 +35,8 @@ public class BoBHash {
     /**
      * BoB hash constructor.
      *
-     * @param hash
-     * @param hashType
+     * @param hash TODO javadoc me please
+     * @param hashType TODO javadoc me please
      */
     public BoBHash(String hash, String hashType) {
         this.hash = StringUtils.requireNotNullNorEmpty(hash, "hash must not be null nor empty");
@@ -97,7 +97,7 @@ public class BoBHash {
     /**
      * Get BoB hash from src attribute string.
      *
-     * @param src
+     * @param src TODO javadoc me please
      * @return the BoB hash
      */
     public static BoBHash fromSrc(String src) {
@@ -109,7 +109,7 @@ public class BoBHash {
     /**
      * Get BoB hash from cid attribute string.
      *
-     * @param cid
+     * @param cid TODO javadoc me please
      * @return the BoB hash
      */
     public static BoBHash fromCid(String cid) {

smack-extensions/src/main/java/org/jivesoftware/smackx/bob/BoBManager.java

@@ -68,7 +68,7 @@ public final class BoBManager extends Manager {
     /**
      * Get the singleton instance of BoBManager.
      *
-     * @param connection
+     * @param connection TODO javadoc me please
      * @return the instance of BoBManager
      */
     public static synchronized BoBManager getInstanceFor(XMPPConnection connection) {
@@ -115,10 +115,10 @@ public final class BoBManager extends Manager {
      * Returns true if Bits of Binary is supported by the server.
      *
      * @return true if Bits of Binary is supported by the server.
-     * @throws NoResponseException
-     * @throws XMPPErrorException
-     * @throws NotConnectedException
-     * @throws InterruptedException
+     * @throws NoResponseException if there was no response from the remote entity.
+     * @throws XMPPErrorException if there was an XMPP error returned.
+     * @throws NotConnectedException if the XMPP connection is not connected.
+     * @throws InterruptedException if the calling thread was interrupted.
      */
     public boolean isSupportedByServer()
             throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -128,14 +128,14 @@ public final class BoBManager extends Manager {
     /**
      * Request BoB data.
      *
-     * @param to
-     * @param bobHash
+     * @param to TODO javadoc me please
+     * @param bobHash TODO javadoc me please
      * @return the BoB data
-     * @throws NotLoggedInException
-     * @throws NoResponseException
-     * @throws XMPPErrorException
-     * @throws NotConnectedException
-     * @throws InterruptedException
+     * @throws NotLoggedInException if the XMPP connection is not authenticated.
+     * @throws NoResponseException if there was no response from the remote entity.
+     * @throws XMPPErrorException if there was an XMPP error returned.
+     * @throws NotConnectedException if the XMPP connection is not connected.
+     * @throws InterruptedException if the calling thread was interrupted.
      */
     public BoBData requestBoB(Jid to, BoBHash bobHash) throws NotLoggedInException, NoResponseException,
             XMPPErrorException, NotConnectedException, InterruptedException {

smack-extensions/src/main/java/org/jivesoftware/smackx/bob/element/BoBExtension.java

@@ -39,9 +39,9 @@ public class BoBExtension extends XHTMLExtension {
     /**
      * Bits of Binary extension constructor.
      *
-     * @param bobHash
-     * @param alt
-     * @param paragraph
+     * @param bobHash TODO javadoc me please
+     * @param alt TODO javadoc me please
+     * @param paragraph TODO javadoc me please
      */
     public BoBExtension(BoBHash bobHash, String alt, String paragraph) {
         this.bobHash = bobHash;

smack-extensions/src/main/java/org/jivesoftware/smackx/bob/element/BoBIQ.java

@@ -47,8 +47,8 @@ public class BoBIQ extends IQ {
     /**
      * Bits of Binary IQ constructor.
      *
-     * @param bobHash
-     * @param bobData
+     * @param bobHash TODO javadoc me please
+     * @param bobData TODO javadoc me please
      */
     public BoBIQ(BoBHash bobHash, BoBData bobData) {
         super(ELEMENT, NAMESPACE);
@@ -59,7 +59,7 @@ public class BoBIQ extends IQ {
     /**
      * Bits of Binary IQ constructor.
      *
-     * @param bobHash
+     * @param bobHash TODO javadoc me please
      */
     public BoBIQ(BoBHash bobHash) {
         this(bobHash, null);