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/web/ui/common/ReportedException.java

@@ -44,7 +44,6 @@ public class ReportedException extends RuntimeException
      * the transaction to rollback.
      * 
      * @param error The error to be thrown
-    * @throws Throwable 
      */
     public static void throwIfNecessary(Throwable error)
     {

source/java/org/alfresco/web/ui/common/Utils.java

@@ -981,7 +981,7 @@ public final class Utils extends StringUtils
    
    /**
     * Parse XML format date YYYY-MM-DDTHH:MM:SS
-    * @param isoDate
+    * @param isoDate String
     * @return Date or null if failed to parse
     */
    public static Date parseXMLDateFormat(String isoDate)
@@ -1184,7 +1184,7 @@ public final class Utils extends StringUtils
     * <p/>
     * "C-3PO" becomes null.
     * 
-    * @param nameFilter
+    * @param nameFilter String
     * @return A Pair<firstName, lastName> if the String is valid, else <tt>null</tt>.
     */
    private static Pair<String, String> tokeniseName(String nameFilter)

source/java/org/alfresco/web/ui/common/component/UISelectList.java

@@ -464,7 +464,7 @@ public class UISelectList extends UIInput implements NamingContainer
     * Set the transient current row index. Setting this value causes all child components to
     * have their ID values reset - so that cached clientID values are regenerated when next requested.
     * 
-    * @param rowIndex
+    * @param rowIndex int
     */
    public void setRowIndex(int rowIndex)
    {

source/java/org/alfresco/web/ui/common/component/data/UIRichList.java

@@ -313,7 +313,7 @@ public class UIRichList extends UIComponentBase implements IDataContainer,Serial
    /**
     * Sets the current page size used for the list.
     * 
-    * @param val
+    * @param val int
     */
    public void setPageSize(int val)
    {

source/java/org/alfresco/web/ui/common/renderer/ActionLinkRenderer.java

@@ -113,8 +113,9 @@ public class ActionLinkRenderer extends BaseRenderer
    /**
     * Render ActionLink as plain link and image
     * 
-    * @param context
-    * @param link
+    * @param context FacesContext
+    * @param out Writer
+    * @param link UIActionLink
     */
    private void renderActionLink(FacesContext context, Writer out, UIActionLink link)
       throws IOException
@@ -176,8 +177,9 @@ public class ActionLinkRenderer extends BaseRenderer
    /**
     * Render ActionLink as plain link and image
     * 
-    * @param context
-    * @param link
+    * @param context FacesContext
+    * @param out Writer
+    * @param link UIActionLink
     */
    private void renderActionLinkAnchor(final FacesContext context, 
                                        final Writer out, 
@@ -272,9 +274,9 @@ public class ActionLinkRenderer extends BaseRenderer
    }
 
    /**
-    * @param link
-    * @param out
-    * @param href
+    * @param link UIActionLink
+    * @param out Writer
+    * @param href String
     */
    private void renderHrefParams(UIActionLink link, Writer out, String href)
       throws IOException
@@ -312,9 +314,11 @@ public class ActionLinkRenderer extends BaseRenderer
    
    /**
     * Render ActionLink as menu image and item link
-    * 
-    * @param context
-    * @param link
+    *
+    * @param context FacesContext
+    * @param out Writer
+    * @param link UIActionLink
+    * @param padding int
     */
    private void renderMenuAction(FacesContext context, Writer out, UIActionLink link, int padding)
       throws IOException

source/java/org/alfresco/web/ui/repo/component/UIActions.java

@@ -281,8 +281,11 @@ public class UIActions extends SelfRenderingComponent
    /**
     * Build an action group as reusable UIActionLink components.
     * 
-    * @param context
-    * @param actionGroup
+    * @param context FacesContext
+    * @param config ActionsConfigElement
+    * @param actionGroup ActionGroup
+    * @param contextId String
+    * @throws IOException
     */
    @SuppressWarnings("unchecked")
    private void buildActionGroup(

source/java/org/alfresco/web/ui/repo/component/UINavigator.java

@@ -405,7 +405,7 @@ public class UINavigator extends SelfRenderingComponent
    /**
     * Sets the active area for the navigator panel
     * 
-    * @param activeArea
+    * @param activeArea String
     */
    public void setActiveArea(String activeArea)
    {