Upgrade to JDK 25, use JavaPoet fork, generate Markdown Javadoc

jwharm commented

2026-03-14 11:35:22 +01:00

Owner

GObject-Introspection API documentation is usually formatted with Markdown. Since JDK 23 (JEP 467) this is also possible in Javadoc. This simplifies Java-GI's documentation converter and allows for some formatting constructs that not implemented in the md->html conversion, such as tables.

Until now, Java-GI still built JDK 22 versioned artifacts to not break compatibility for no reason. Instead of upgrading to JDK 23 for JEP 467, we move to the current (and LTS) version 25.

Because upstream square's JavaPoet is unmaintained and didn't support JEP 467, I forked it: https://codeberg.org/java-gi/javapoet
The forked JavaPoet can generate Markdown javadoc with an option on the JavaFile class. The fork is included in the java-gi git repository as a submodule.

The switch to Markdown Javadoc is mostly a change in the Javadoc class. The javadoc for literally-generated methods has also been updated.

GObject-Introspection API documentation is usually formatted with Markdown. Since JDK 23 (JEP 467) this is also possible in Javadoc. This simplifies Java-GI's documentation converter and allows for some formatting constructs that not implemented in the md->html conversion, such as tables. Until now, Java-GI still built JDK 22 versioned artifacts to not break compatibility for no reason. Instead of upgrading to JDK 23 for JEP 467, we move to the current (and LTS) version 25. Because upstream square's JavaPoet is unmaintained and didn't support JEP 467, I forked it: https://codeberg.org/java-gi/javapoet The forked JavaPoet can generate Markdown javadoc with an option on the JavaFile class. The fork is included in the java-gi git repository as a submodule. The switch to Markdown Javadoc is mostly a change in the Javadoc class. The javadoc for literally-generated methods has also been updated.

jwharm added 7 commits

2026-03-14 11:35:22 +01:00