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/security/permissions/PermissionServiceSPI.java

@@ -45,7 +45,7 @@ public interface PermissionServiceSPI extends PermissionService
     /**
      * Get the permissions that can be set for a given type
      * 
-     * @param type
+     * @param type QName
      * @return the set of permissions
      */
     public Set<PermissionReference> getSettablePermissionReferences(QName type);
@@ -53,7 +53,7 @@ public interface PermissionServiceSPI extends PermissionService
     /**
      * Get the permissions that can be set for a given type
      * 
-     * @param nodeRef
+     * @param nodeRef NodeRef
      * @return the set of permissions
      */
     public Set<PermissionReference> getSettablePermissionReferences(NodeRef nodeRef);
@@ -62,7 +62,7 @@ public interface PermissionServiceSPI extends PermissionService
      * Get the permissions that have been set on the given node (it knows
      * nothing of the parent permissions)
      * 
-     * @param nodeRef
+     * @param nodeRef NodeRef
      * @return the node permission entry
      */
     public NodePermissionEntry getSetPermissions(NodeRef nodeRef);
@@ -71,8 +71,8 @@ public interface PermissionServiceSPI extends PermissionService
      * Check that the given authentication has a particular permission for the
      * given node. (The default behaviour is to inherit permissions)
      * 
-     * @param nodeRef
-     * @param perm
+     * @param nodeRef NodeRef
+     * @param perm PermissionReference
      * @return the access status
      */
     public AccessStatus hasPermission(NodeRef nodeRef, PermissionReference perm);
@@ -81,35 +81,35 @@ public interface PermissionServiceSPI extends PermissionService
      * Where is the permission set that controls the behaviour for the given
      * permission for the given authentication to access the specified name.
      * 
-     * @param nodeRef
-     * @param perm
+     * @param nodeRef NodeRef
+     * @param perm PermissionReference
      * @return the node permission entry
      */
     public NodePermissionEntry explainPermission(NodeRef nodeRef, PermissionReference perm);
     
     /**
      * Delete the permissions defined by the nodePermissionEntry
-     * @param nodePermissionEntry
+     * @param nodePermissionEntry NodePermissionEntry
      */
     public void deletePermissions(NodePermissionEntry nodePermissionEntry);
     
     /**
      * Delete a single permission entry
-     * @param permissionEntry
+     * @param permissionEntry PermissionEntry
      */
     public void deletePermission(PermissionEntry permissionEntry);
 
     /**
      * Add or set a permission entry on a node.
-     * 
-     * @param permissionEntry
+     *
+     * @param permissionEntry PermissionEntry
      */
     public void setPermission(PermissionEntry permissionEntry);
     
     /**
      * Set the permissions on a node.
      * 
-     * @param nodePermissionEntry
+     * @param nodePermissionEntry NodePermissionEntry
      */
     public void setPermission(NodePermissionEntry nodePermissionEntry);
 
@@ -117,7 +117,7 @@ public interface PermissionServiceSPI extends PermissionService
      * Get the permission reference for the given data type and permission name.
      * 
      * @param qname - may be null if the permission name is unique
-     * @param permissionName
+     * @param permissionName String
      * @return the permission reference
      */
     public PermissionReference getPermissionReference(QName qname, String permissionName);
@@ -125,7 +125,7 @@ public interface PermissionServiceSPI extends PermissionService
     /**
      * Get the permission reference by permission name.
      *
-     * @param permissionName
+     * @param permissionName String
      * @return the permission reference
      */
     public PermissionReference getPermissionReference(String permissionName);
@@ -134,20 +134,20 @@ public interface PermissionServiceSPI extends PermissionService
     /**
      * Get the string that can be used to identify the given permission reference.
      * 
-     * @param permissionReference
+     * @param permissionReference PermissionReference
      * @return the permission short name
      */
     public String getPermission(PermissionReference permissionReference);
     
     /**
      * Delete permissions for the given recipient.
-     * @param recipient
+     * @param recipient String
      */
     public void deletePermissions(String recipient);
     
     /**
      * Get the permissions set for the store
-     * @param storeRef
+     * @param storeRef StoreRef
      * @return - the node permission entry
      */
     public NodePermissionEntry getSetPermissions(StoreRef storeRef);