From d6683f4ad77727a43799a08b5f80e12ff4942878 Mon Sep 17 00:00:00 2001 From: Gbenga Adeyi Date: Sat, 23 May 2026 11:39:56 +0100 Subject: [PATCH 1/5] Fix misplaced/mispositioned doc comments in Cell --- lib/src/main/java/dev/foliopdf/Cell.java | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/lib/src/main/java/dev/foliopdf/Cell.java b/lib/src/main/java/dev/foliopdf/Cell.java index 4e6474c..4e6ae0b 100644 --- a/lib/src/main/java/dev/foliopdf/Cell.java +++ b/lib/src/main/java/dev/foliopdf/Cell.java @@ -108,12 +108,6 @@ public Cell border(double width, Color color) { return this; } - /** - * Provides a hint for the preferred width of this cell in points. - * - * @param pts the preferred width in points - * @return this cell, for chaining - */ /** * Sets individual borders on each side of this cell with independent width and color. * @@ -133,6 +127,12 @@ public Cell borders(double topW, Color top, double rightW, Color right, return this; } + /** + * Provides a hint for the preferred width of this cell in points. + * + * @param pts the preferred width in points + * @return this cell, for chaining + */ public Cell widthHint(double pts) { FolioNative.cellSetWidthHint(handle, pts); return this; From 6c800f787dfa8362891b849c34ebc9564826e60d Mon Sep 17 00:00:00 2001 From: Gbenga Adeyi Date: Sat, 23 May 2026 11:49:39 +0100 Subject: [PATCH 2/5] Fix misplaced/mispositioned doc comments in Heading --- lib/src/main/java/dev/foliopdf/Heading.java | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/lib/src/main/java/dev/foliopdf/Heading.java b/lib/src/main/java/dev/foliopdf/Heading.java index c0757fd..ccf6842 100644 --- a/lib/src/main/java/dev/foliopdf/Heading.java +++ b/lib/src/main/java/dev/foliopdf/Heading.java @@ -64,12 +64,6 @@ public static Heading ofEmbedded(String text, HeadingLevel level, Font font) { return new Heading(h); } - /** - * Sets the text alignment for this heading. - * - * @param align the desired {@link Align} value - * @return this heading, for chaining - */ /** * Replaces the heading text with styled runs from a {@link RunList}. * @@ -81,6 +75,12 @@ public Heading setRuns(RunList runs) { return this; } + /** + * Sets the text alignment for this heading. + * + * @param align the desired {@link Align} value + * @return this heading, for chaining + */ public Heading align(Align align) { FolioNative.headingSetAlign(handle.get(), align.value()); return this; From 62b2f04362df12d0b1eb958d3409597634b96c21 Mon Sep 17 00:00:00 2001 From: Gbenga Adeyi Date: Sat, 23 May 2026 11:53:12 +0100 Subject: [PATCH 3/5] Fix misplaced/mispositioned doc comments in ListElement --- lib/src/main/java/dev/foliopdf/ListElement.java | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/lib/src/main/java/dev/foliopdf/ListElement.java b/lib/src/main/java/dev/foliopdf/ListElement.java index da63b0e..d8a2844 100644 --- a/lib/src/main/java/dev/foliopdf/ListElement.java +++ b/lib/src/main/java/dev/foliopdf/ListElement.java @@ -93,12 +93,6 @@ public ListElement leading(double leading) { return this; } - /** - * Appends a text item to this list. - * - * @param text the item text - * @return this list, for chaining - */ /** * Adds a list item with styled text runs from a {@link RunList}. * @@ -122,6 +116,12 @@ public ListElement itemRunsWithSublist(RunList runs) { return new ListElement(h); } + /** + * Appends a text item to this list. + * + * @param text the item text + * @return this list, for chaining + */ public ListElement item(String text) { FolioNative.listAddItem(handle.get(), text); return this; From ee2f37df8870e3561ea6edbac2ab07a7e01c40f5 Mon Sep 17 00:00:00 2001 From: Gbenga Adeyi Date: Sat, 23 May 2026 11:56:34 +0100 Subject: [PATCH 4/5] Fix misplaced/mispositioned doc comments in Paragraph --- lib/src/main/java/dev/foliopdf/Paragraph.java | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/lib/src/main/java/dev/foliopdf/Paragraph.java b/lib/src/main/java/dev/foliopdf/Paragraph.java index efe1bdc..6b3413a 100644 --- a/lib/src/main/java/dev/foliopdf/Paragraph.java +++ b/lib/src/main/java/dev/foliopdf/Paragraph.java @@ -48,15 +48,6 @@ public static Paragraph of(String text, Font font, double fontSize) { return new Paragraph(h); } - /** - * Creates a paragraph that embeds the font subset in the PDF output. - * - * @param text the paragraph text - * @param font the font to embed - * @param fontSize the font size in points - * @return a new {@link Paragraph} with an embedded font - * @throws FolioException if the native call fails - */ /** * Creates a paragraph with the given text and font size using the default Helvetica font. * @@ -68,6 +59,15 @@ public static Paragraph of(String text, double fontSize) { return of(text, Font.helvetica(), fontSize); } + /** + * Creates a paragraph that embeds the font subset in the PDF output. + * + * @param text the paragraph text + * @param font the font to embed + * @param fontSize the font size in points + * @return a new {@link Paragraph} with an embedded font + * @throws FolioException if the native call fails + */ public static Paragraph ofEmbedded(String text, Font font, double fontSize) { long h = FolioNative.paragraphNewEmbedded(text, font.handle(), fontSize); if (h == 0) throw new FolioException("Failed to create embedded paragraph: " + FolioNative.lastError()); From 09bbc7e3fb2fc12827de5e3f852d3a24b198ea56 Mon Sep 17 00:00:00 2001 From: Gbenga Adeyi Date: Sat, 23 May 2026 11:59:03 +0100 Subject: [PATCH 5/5] Fix misplaced/mispositioned doc comments in PdfMerger --- lib/src/main/java/dev/foliopdf/PdfMerger.java | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/lib/src/main/java/dev/foliopdf/PdfMerger.java b/lib/src/main/java/dev/foliopdf/PdfMerger.java index f5c5c73..e96162a 100644 --- a/lib/src/main/java/dev/foliopdf/PdfMerger.java +++ b/lib/src/main/java/dev/foliopdf/PdfMerger.java @@ -143,12 +143,6 @@ public void save(String path) { FolioNative.mergeSave(handle.get(), path); } - /** - * Renders the merged document to an in-memory byte array. - * - * @return the PDF bytes - * @throws FolioException if the write fails - */ /** Returns the number of pages in the merged document. */ public int pageCount() { return FolioNative.mergePageCount(handle.get()); @@ -190,6 +184,12 @@ public PdfMerger cropPage(int index, double x1, double y1, double x2, double y2) return this; } + /** + * Renders the merged document to an in-memory byte array. + * + * @return the PDF bytes + * @throws FolioException if the write fails + */ public byte[] writeToBuffer() { long buf = FolioNative.mergeWriteToBuffer(handle.get()); if (buf == 0) throw new FolioException("Failed to write merged PDF to buffer: " + FolioNative.lastError());