Merged 5.2.0 (5.2.0) to HEAD (5.2)

133868 rmunteanu: REPO-1746: Merge fixes for 5.2 GA issues to 5.2.0 branch
      Merged 5.2.N (5.2.1) to 5.2.0 (5.2.0)
         133552 mward: REPO-1661: properties and aspects no longer appear in /comments listing.


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

source/java/org/alfresco/rest/api/People.java

@@ -31,6 +31,8 @@ import org.alfresco.rest.framework.resource.parameters.Parameters;
 import org.alfresco.service.cmr.repository.NodeRef;
 import org.alfresco.service.cmr.security.NoSuchPersonException;
 
+import java.util.List;
+
 public interface People
 {
 	String DEFAULT_USER = "-me-";
@@ -45,11 +47,21 @@ public interface People
     NodeRef getAvatar(String personId);
 
     /**
+     * Get a person. This included a full representation of the person.
      * 
      * @throws NoSuchPersonException if personId does not exist
      */
     Person getPerson(final String personId);
 
+    /**
+     * Get a person, specifying optional includes as required.
+     * 
+     * @param personId
+     * @param include
+     * @return
+     */
+    Person getPerson(String personId, List<String> include);
+    
     /**
      * Create a person.
      *