Skip to content

Commit 0939cf5

Browse files
marko-bekhtamarko-bekhta
committed
HV-2244 Tune the content of javadoc jars to reduce the size of files published to Maven Central
1 parent e1f271a commit 0939cf5

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

‎parents/public/pom.xml‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,29 @@
131131
<goal>jar</goal>
132132
</goals>
133133
<phase>${javadoc.generate.jar.phase}</phase>
134+
<!--
135+
Reduce the size of per-module javadoc jars published to Maven Central.
136+
These options are intentionally NOT in the shared pluginManagement configuration,
137+
so that the aggregated javadoc published to docs.hibernate.org is unaffected.
138+
-->
139+
<configuration>
140+
<!--
141+
Use a separate output directory so that the reduced javadoc
142+
does not get mixed with the full javadoc from the generate-javadoc execution.
143+
-->
144+
<outputDirectory>${project.build.directory}/javadoc-jar</outputDirectory>
145+
<additionalOptions>
146+
<additionalOption>-html5</additionalOption>
147+
<additionalOption>-Xdoclint:all,-missing</additionalOption>
148+
<additionalOption>--add-script resources/theme-switch.js</additionalOption>
149+
<!-- Don't repeat inherited method docs; link to the declaring type instead -->
150+
<additionalOption>--override-methods summary</additionalOption>
151+
</additionalOptions>
152+
<!-- class-use pages add significant size; IDEs provide better "find usages" -->
153+
<use>false</use>
154+
<!-- Class hierarchy tree adds bulk; IDEs show this better -->
155+
<notree>true</notree>
156+
</configuration>
134157
</execution>
135158
</executions>
136159
</plugin>

0 commit comments

Comments
 (0)