Clean up dspace-api doc comment warnings

dspace-api/src/main/java/org/dspace/content/LicenseUtils.java

@@ -32,8 +32,8 @@ public class LicenseUtils
      * Return the text of the license that the user has granted/must grant
      * before for submit the item. The license text is build using the template
      * defined for the collection if any or the wide site configuration. In the
-     * license text the following substitution can be used. {0} the eperson
-     * firstname<br>
+     * license text the following substitutions can be used.<br>
+     * {0} the eperson firstname<br>
      * {1} the eperson lastname<br>
      * {2} the eperson email<br>
      * {3} the current date<br>
@@ -46,7 +46,7 @@ public class LicenseUtils
      * {x} any addition argument supplied wrapped in the
      * LicenseArgumentFormatter based on his type (map key)
      * 
-     * @see LicenseArgumentFormatter
+     * @see license.LicenseArgumentFormatter
      * @param locale
      * @param collection
      * @param item
@@ -90,15 +90,15 @@ public class LicenseUtils
     }
 
     /**
-     * Utility method if no additional arguments has need to be supplied to the
-     * license template. (i.e. call the full getLicenseText supplying
-     * <code>null</code> for the additionalInfo argument)
-     * 
+     * Utility method if no additional arguments are to be supplied to the
+     * license template. (equivalent to calling the full getLicenseText
+     * supplying {@code null} for the additionalInfo argument)
+     *
      * @param locale
      * @param collection
      * @param item
      * @param eperson
-     * @return
+     * @return the license text, with no custom substitutions.
      */
     public static String getLicenseText(Locale locale, Collection collection,
             Item item, EPerson eperson)