Fix generation of maven site

- update maven-site-plugin to 4.0.0-M9
- use wagon-ssh extension for deployment
- disable doclint
- don't fail the build for javadoc warnings

Change-Id: I81f7229deaf6892416ce4cebd6c122f00a857d51
This commit is contained in:
Matthias Sohn 2023-09-07 00:06:52 +02:00
parent ea02caf1e7
commit b438804847
2 changed files with 31 additions and 6 deletions

View File

@ -175,11 +175,11 @@
<plugin> <plugin>
<groupId>org.apache.maven.plugins</groupId> <groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId> <artifactId>maven-site-plugin</artifactId>
<version>3.12.1</version> <version>4.0.0-M9</version>
<dependencies> <dependencies>
<dependency><!-- add support for ssh/scp --> <dependency><!-- add support for ssh/scp -->
<groupId>org.apache.maven.wagon</groupId> <groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ssh-external</artifactId> <artifactId>wagon-ssh</artifactId>
<version>3.5.3</version> <version>3.5.3</version>
</dependency> </dependency>
</dependencies> </dependencies>

33
pom.xml
View File

@ -337,11 +337,11 @@
<plugin> <plugin>
<groupId>org.apache.maven.plugins</groupId> <groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId> <artifactId>maven-site-plugin</artifactId>
<version>3.12.1</version> <version>4.0.0-M9</version>
<dependencies> <dependencies>
<dependency><!-- add support for ssh/scp --> <dependency><!-- add support for ssh/scp -->
<groupId>org.apache.maven.wagon</groupId> <groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ssh-external</artifactId> <artifactId>wagon-ssh</artifactId>
<version>3.5.3</version> <version>3.5.3</version>
</dependency> </dependency>
</dependencies> </dependencies>
@ -468,7 +468,7 @@
to check javadoc on tests. We can reconsider to configure this on javadoc to check javadoc on tests. We can reconsider to configure this on javadoc
when it starts supporting access specifiers so that we can set when it starts supporting access specifiers so that we can set
-Xdoclint:all,-missing/private --> -Xdoclint:all,-missing/private -->
<additionalJOption>-Xdoclint:none</additionalJOption>--> <additionalJOption>-Xdoclint:none</additionalJOption>
<encoding>${project.build.sourceEncoding}</encoding> <encoding>${project.build.sourceEncoding}</encoding>
<quiet>true</quiet> <quiet>true</quiet>
<failOnWarnings>true</failOnWarnings> <failOnWarnings>true</failOnWarnings>
@ -610,7 +610,32 @@
</reportSet> </reportSet>
</reportSets> </reportSets>
<configuration> <configuration>
<failOnWarnings>true</failOnWarnings> <failOnWarnings>false</failOnWarnings>
<additionalJOption>-Xdoclint:none</additionalJOption>
<encoding>${project.build.sourceEncoding}</encoding>
<quiet>true</quiet>
<failOnWarnings>false</failOnWarnings>
<excludePackageNames>org.eclipse.jgit.http.test</excludePackageNames>
<links>
<link>https://docs.oracle.com/en/java/javase/11/docs/api</link>
</links>
<tags>
<tag>
<name>apiNote</name>
<placement>a</placement>
<head>API Note:</head>
</tag>
<tag>
<name>implSpec</name>
<placement>a</placement>
<head>Implementation Requirements:</head>
</tag>
<tag>
<name>implNote</name>
<placement>a</placement>
<head>Implementation Note:</head>
</tag>
</tags>
</configuration> </configuration>
</plugin> </plugin>
<plugin> <plugin>