Merged HEAD-BUG-FIX (5.1/Cloud) to HEAD (5.1/Cloud)

107541: Merged 5.0.N (5.0.3) to HEAD-BUG-FIX (5.1/Cloud) (PARTIAL MERGE)
      107413: Merged DEV to 5.0.N (5.0.3)
         106858 : MNT-13545: JavaDoc : Inconsistencies between the Java doc and the actual code
            - Cleaning of Javadoc,
   107565: MNT-13545 Fix compilation after merge of Javadoc


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@107633 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/util/schemacomp/model/DbObject.java

@@ -42,8 +42,8 @@ public interface DbObject
      * <code>a.sameAs(b) == true</code> it makes it easier to show the differences as related, i.e. a and b are
      * different rather than, a is only in the 'left' tree and b is only in the 'right' tree. 
      *  
-     * @param other
-     * @return
+     * @param other DbObject
+     * @return boolean
      */
     boolean sameAs(DbObject other);
     
@@ -69,7 +69,7 @@ public interface DbObject
      * Allows a visitor to be invoked against this DbObject. Implementations should ensure that child
      * objects are visited first (by calling accept on them) before invoking the visitor on itself.
      * 
-     * @param visitor
+     * @param visitor DbObjectVisitor
      */
     void accept(DbObjectVisitor visitor);
     
@@ -85,7 +85,7 @@ public interface DbObject
      * Sets the parent object.
      * 
      * @see #getParent()
-     * @param parent
+     * @param parent DbObject
      */
     void setParent(DbObject parent);
     
@@ -101,7 +101,7 @@ public interface DbObject
     /**
      * Set/override the validators associated with this database object.
      * 
-     * @param validators
+     * @param validators List<DbValidator>
      */
     void setValidators(List<DbValidator> validators);
     
@@ -116,7 +116,7 @@ public interface DbObject
      * Is there at least one validator that assumes object-level validation
      * that removes the requirement for reporting of differences for this object?
      * 
-     * @return
+     * @return boolean
      */
     boolean hasObjectLevelValidator();