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/service/cmr/transfer/TransferService.java

@@ -46,7 +46,7 @@ public interface TransferService
       * 
       * @param targetName the name of the target to transfer to
       * The following properties must be set, nodes
-      * @param definition, the definition of the transfer. Specifies which nodes to transfer. 
+      * @param definition the definition of the transfer. Specifies which nodes to transfer.
       * @throws TransferException
       * @return the node reference of the transfer report
       */
@@ -129,15 +129,15 @@ public interface TransferService
     /**
      * Create and save a new transfer target.  Creates and saves a new transfer target with a single, but long, method call.
      *  
-     * @param name, the name of this transfer target, which must be unique
-     * @param title, the display name of this transfer target
-     * @param description,
-     * @param endpointProtocol, either http or https 
-     * @param endpointHost, 
-     * @param endpointPort,
-     * @param endpointPath, 
-     * @param username, 
-     * @param password,
+     * @param name the name of this transfer target, which must be unique
+     * @param title the display name of this transfer target
+     * @param description String
+     * @param endpointProtocol either http or https
+     * @param endpointHost String
+     * @param endpointPort int
+     * @param endpointPath String
+     * @param username String
+     * @param password char[]
      * @return the newly created transfer target.
      */
     @Auditable
@@ -170,7 +170,7 @@ public interface TransferService
 
     /**
       * Get All the transfer targets for a particular transfer target group.
-      * @param groupName, the name of the transfer group
+      * @param groupName the name of the transfer group
       */
     @NotAuditable
     public Set<TransferTarget>getTransferTargets(String groupName) throws TransferException;
@@ -184,7 +184,7 @@ public interface TransferService
     
     /**
      * Test to see if the target with the specified name exists
-     * @param name
+     * @param name String
      * @return true if the specified target exists, and false otherwise
      */
     @NotAuditable
@@ -193,7 +193,7 @@ public interface TransferService
     /**
      * Delete a transfer target.  After calling this method the transfer target will no longer exist.
      * @throws TransferException - target does not exist
-     * @param name, the name of this transfer target,
+     * @param name the name of this transfer target,
      */
     @Auditable(parameters={"name"})
     public void deleteTransferTarget(String name) throws TransferException;
@@ -215,7 +215,7 @@ public interface TransferService
      *    name, must be specified.
      *    nodeRef, if specified will be ignored.
      *    
-     *    @param update
+     *    @param update TransferTarget
      */
     @Auditable
     public TransferTarget saveTransferTarget(TransferTarget update) throws TransferException;
@@ -244,7 +244,7 @@ public interface TransferService
      * 
      * @param transferId the unique identifier of the transfer to cancel.
      * 
-     * @see TransferEventBegin;
+     * @see org.alfresco.service.cmr.transfer.TransferEventBegin
      */
     @Auditable(parameters={"transferId"})
     public void cancelAsync(String transferId);