Refactor class documentation

Author: Egor Martsynkovsky

kernel/src/main/java/com/itextpdf/kernel/utils/PdfSplitter.java

@@ -113,11 +113,12 @@ public void setPreserveOutlines(boolean preserveOutlines) {
     }
 
     /**
-     * Splits the document basing on the given size.
+     * Splits the document basing on the given size specified in bytes.
+     *
+     * @param size <strong>Preferred</strong> size specified in bytes for splitting.
      *
-     * @param size <strong>Preferred</strong> size for splitting.
      * @return The documents which the source document was split into.
-     *         Be warned that these documents are not closed.
+     * Be warned that these documents are not closed.
      */
     public List<PdfDocument> splitBySize(long size) {
         List<PageRange> splitRanges = new ArrayList<>();
@@ -196,6 +197,7 @@ public void splitByPageCount(int pageCount, IDocumentReadyListener documentReady
      * Splits a document into smaller documents with no more than @pageCount pages each.
      *
      * @param pageCount the biggest possible number of pages in a split document.
+     *
      * @return the list of resultant documents. By warned that they are not closed.
      */
     public List<PdfDocument> splitByPageCount(int pageCount) {
@@ -210,6 +212,7 @@ public List<PdfDocument> splitByPageCount(int pageCount) {
      * Extracts the specified page ranges from a document.
      *
      * @param pageRanges the list of page ranges for each of the resultant document.
+     *
      * @return the list of the resultant documents for each of the specified page range.
      * Be warned that these documents are not closed.
      */
@@ -229,6 +232,7 @@ public List<PdfDocument> extractPageRanges(List<PageRange> pageRanges) {
      * Extracts the specified page ranges from a document.
      *
      * @param pageRange the page range to be extracted from the document.
+     *
      * @return the resultant document containing the pages specified by the provided page range.
      * Be warned that this document is not closed.
      */
@@ -244,7 +248,9 @@ public PdfDocument getPdfDocument() {
      * This method is called when another split document is to be created.
      * You can override this method and return your own {@link PdfWriter} depending on your needs.
      *
-     * @param documentPageRange the page range of the original document to be included in the document being created now.
+     * @param documentPageRange the page range of the original document to be included
+     *                          in the document being created now.
+     *
      * @return the PdfWriter instance for the document which is being created.
      */
     protected PdfWriter getNextPdfWriter(PageRange documentPageRange) {
@@ -269,6 +275,7 @@ public interface IDocumentReadyListener {
      * and places the entire hierarchy in a separate document ( outlines and pages ) .
      *
      * @param outlineTitles list of outline titles .
+     *
      * @return Collection of {@link PdfDocument} which contains split parts of a document
      */
     public List<PdfDocument> splitByOutlines(List<String> outlineTitles) {