Skip to content

Do not include web fonts in javadoc jar#1619

Merged
hankem merged 1 commit into
mainfrom
no-fonts-in-javadoc
Jun 20, 2026
Merged

Do not include web fonts in javadoc jar#1619
hankem merged 1 commit into
mainfrom
no-fonts-in-javadoc

Conversation

@hankem

@hankem hankem commented May 17, 2026

Copy link
Copy Markdown
Member

Commit 912abfd advanced maxSupportedJavaVersion, which is also used as languageVersion for the javadocTool, from Java 21 to Java 25.

Unlike javadoc 21, javadoc 25 by default includes ~4 MB of fonts in every *-javadoc.jar:
javadoc --no-fonts reduces the total size of published *-javadoc.jars by a factor of ~10, e.g.

  • archunit-javadoc.jar from 5.4 MiB to 1.6 MiB (was 1.4 MiB with javadoc 21)
  • archunit-junit5-api-javadoc.jar from 4.0 MiB to 0.1 MiB (was 0.1 MiB with javadoc 21)

@hankem hankem force-pushed the no-fonts-in-javadoc branch from 8724d40 to 122ac38 Compare May 17, 2026 19:58
javadoc {
options.addBooleanOption('html5', true)
} No newline at end of file
options.addBooleanOption("-no-fonts", true)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you check that this works? I think the option should be --no-fonts (two dashes), see e.g. https://github.com/apache/maven-javadoc-plugin/pull/1309/changes

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, for sure. 🙂

With addBooleanOption("--no-fonts", true),

./gradlew javadoc

fails with

> Task :archunit:javadoc FAILED
error: invalid flag: ---no-fonts
Did you mean: --no-fonts
For more details on available options, use --help or --help-extra
1 error

@hankem hankem force-pushed the no-fonts-in-javadoc branch from 122ac38 to 8e50b15 Compare June 19, 2026 10:29
Commit 912abfd advanced `maxSupportedJavaVersion`,
which is also used as `languageVersion` for the `javadocTool`, from Java 21 to Java 25.

Unlike javadoc 21, javadoc 25 by default includes ~4 MB of fonts in every `*-javadoc.jar`:
`javadoc --no-fonts` reduces the total size of published `*-javadoc.jar`s by a factor of ~10,
e.g.
- `archunit-javadoc.jar` from 5.4 MiB to 1.6 MiB (was 1.4 MiB with javadoc 21)
- `archunit-junit5-api-javadoc.jar` from 4.0 MiB to 0.1 MiB (was 0.1 MiB with javadoc 21)

Signed-off-by: Manfred Hanke <Manfred.Hanke@tngtech.com>
@hankem hankem force-pushed the no-fonts-in-javadoc branch from 8e50b15 to ef86946 Compare June 20, 2026 20:31
@hankem hankem enabled auto-merge June 20, 2026 20:31
@hankem hankem merged commit 7bb8965 into main Jun 20, 2026
32 checks passed
@hankem hankem deleted the no-fonts-in-javadoc branch June 20, 2026 20:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants