Tidy up:

1) Comments
2) Facebook exception handling (would of been useful yesterday)
3) Addition of Facebook.getAppFriends to javascript API (more useful than existing all friends method)
4) Fixes to Document Library sample

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

source/java/org/alfresco/web/scripts/FormData.java

@@ -114,11 +114,21 @@ public class FormData implements Serializable, Scopeable
         return Context.getCurrentContext().newArray(this.scope, fields);        
     }
 
+    /**
+     * Gets parameters encoded in the form data
+     * 
+     * @return  map (name, value) of parameters
+     */
     /*package*/ Map<String, String> getParameters()
     {
         return getParametersMap();
     }
     
+    /**
+     * Gets files encoded in form data
+     * 
+     * @return  map (name, ScriptContent) of files
+     */
     /*package*/ Map<String, ScriptContent> getFiles()
     {
         return getFilesMap();
@@ -127,7 +137,7 @@ public class FormData implements Serializable, Scopeable
     /**
      * Helper to parse servlet request form data
      * 
-     * @return  parsed form data
+     * @return  map of all form fields
      */
     private Map<String, FormField> getFieldsMap()
     {
@@ -155,6 +165,11 @@ public class FormData implements Serializable, Scopeable
         return fields;
     }
  
+    /**
+     * Helper to parse servlet request form data
+     * 
+     * @return  map of all form parameters
+     */
     private Map<String, String> getParametersMap()
     {
         if (parameters == null)
@@ -173,6 +188,11 @@ public class FormData implements Serializable, Scopeable
         return parameters;
     }
     
+    /**
+     * Helper to parse servlet request form data
+     * 
+     * @return  map of all form files
+     */
     private Map<String, ScriptContent> getFilesMap()
     {
         if (files == null)