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/repo/transfer/TransferSummaryReport.java

@@ -20,53 +20,49 @@ public interface TransferSummaryReport
 
     /**
      * Log the creation of a new node
-     * 
-     * @param transferId
-     * @param sourceNode
-     * @param destNode
-     * @param newPath
-     * @param orphan
+     *
+     * @param sourceNode NodeRef
+     * @param destNode NodeRef
+     * @param newParent NodeRef
+     * @param newPath String
+     * @param orphan boolean
      */
     void logSummaryCreated(NodeRef sourceNode, NodeRef destNode, NodeRef newParent, String newPath, boolean orphan);
 
     /**
      * Log the creation of a new node
-     * 
-     * @param transferId
-     * @param sourceNode
-     * @param destNode
-     * @param path
-     *            The path of the updated node
-     * @param orphan
+     *
+     * @param sourceNode NodeRef
+     * @param destNode NodeRef
+     * @param path The path of the updated node
      */
     void logSummaryUpdated(NodeRef sourceNode, NodeRef destNode, String path);
 
     /**
      * Log the deletion of a node
      * 
-     * @param transferId
-     * @param sourceNode
-     * @param destNode
-     * @param path
-     *            The path of the deleted node
-     * @param orphan
+     * @param sourceNode NodeRef
+     * @param destNode NodeRef
+     * @param path The path of the updated node
      */
     void logSummaryDeleted(NodeRef sourceNode, NodeRef destNode, String path);
 
     /**
      * After the transfer has completed this method reads the log.
-     * 
-     * @param transferId
-     * @return the log
+     *
+     * @param sourceNodeRef NodeRef
+     * @param destNodeRef NodeRef
+     * @param oldPath String
+     * @param newParent NodeRef
+     * @param newPath String
+     *
      */
-
     void logSummaryMoved(NodeRef sourceNodeRef, NodeRef destNodeRef, String oldPath, NodeRef newParent, String newPath);
 
     /**
      * log an ad-hoc message
      * 
-     * @param transferId
-     * @param obj
+     * @param obj Object
      * @throws TransferException
      */
     void logSummaryComment(Object obj) throws TransferException;
@@ -74,9 +70,8 @@ public interface TransferSummaryReport
     /**
      * log an ad-hoc message and an exception
      * 
-     * @param transferId
-     * @param obj
-     * @param ex
+     * @param obj Object
+     * @param ex Throwable
      * @throws TransferException
      */
     void logSummaryException(Object obj, Throwable ex) throws TransferException;
@@ -84,8 +79,7 @@ public interface TransferSummaryReport
     /**
      * update the status of the transfer
      * 
-     * @param transferId
-     * @param status
+     * @param status TransferProgress.Status
      * @throws TransferException
      */
     void logSummaryUpdateStatus(TransferProgress.Status status) throws TransferException;