Fix errors while generating javadocs

DEVSIX-5807

Author: Eugene Bochilo

commons/src/main/java/com/itextpdf/commons/actions/AbstractStatisticsEvent.java

@@ -38,7 +38,9 @@ public abstract class AbstractStatisticsEvent extends AbstractProductITextEvent
     private static final Logger LOGGER = LoggerFactory.getLogger(AbstractStatisticsEvent.class);
 
     /**
-     * @see AbstractProductITextEvent#AbstractProductITextEvent(ProductData)
+     * Creates instance of abstract statistics iText event based on passed product data. Only for internal usage.
+     *
+     * @param productData is a description of the product which has generated an event
      */
     protected AbstractStatisticsEvent(ProductData productData) {
         super(productData);
@@ -49,7 +51,7 @@ protected AbstractStatisticsEvent(ProductData productData) {
      * By default prints log warning and returns <code>null</code>.
      *
      * @param statisticsName name of statistics based on which aggregator will be created.
-     *                       Shall be one of those returned from {@link this#getStatisticsNames()}
+     *                       Shall be one of those returned from {@link AbstractStatisticsEvent#getStatisticsNames()}
      * @return new instance of {@link AbstractStatisticsAggregator}
      */
     public AbstractStatisticsAggregator createStatisticsAggregatorFromName(String statisticsName) {

commons/src/main/java/com/itextpdf/commons/utils/FileUtil.java

@@ -203,7 +203,10 @@ public static String getParentDirectoryUri(File file) throws MalformedURLExcepti
 
     /**
      * Deletes a file and returns whether the operation succeeded.
-     * Node that only *files* are supported, not directories.
+     * Note that only *files* are supported, not directories.
+     *
+     * @param file file to be deleted
+     * @return true if file was deleted successfully, false otherwise
      */
     public static boolean deleteFile(File file) {
         return file.delete();
@@ -215,6 +218,8 @@ public static boolean deleteFile(File file) {
      * @param url of resource
      *
      * @return parent directory path| the same path if a catalog`s url is passed;
+     * @throws URISyntaxException if this URL is not formatted strictly according
+     *                            to RFC2396 and cannot be converted to a URI.
      */
     public static String parentDirectory(URL url) throws URISyntaxException {
             return url.toURI().resolve(".").toString();