build: maven-javadoc-plugin для публичного API core
- Корневой pom: версия 3.12.0 + pluginManagement (outputDirectory закреплён
на target/site, цель — только javadoc:javadoc, лайфцикл verify не меняется).
- wordpdf-core объявляет плагин без executions; wordpdf-app javadoc не генерирует.
- Правки javadoc-комментарий по ошибкам doclint: {@code <=} в ChartImageHandler,
полные имена {@link ru.pjandro.wordpdf.ConversionException} в DocToDocx.
This commit is contained in:
@@ -39,6 +39,8 @@
|
||||
|
||||
<!-- Покрытие: последняя стабильная на Maven Central -->
|
||||
<jacoco.version>0.8.15</jacoco.version>
|
||||
<!-- Javadoc публичного API core: последняя стабильная на Maven Central -->
|
||||
<maven-javadoc-plugin.version>3.12.0</maven-javadoc-plugin.version>
|
||||
<!-- Пустой дефолт: при -Djacoco.skip=true surefire не споткнётся
|
||||
о неразвёрнутый @{argLine}; prepare-agent перезаписывает его -->
|
||||
<argLine></argLine>
|
||||
@@ -156,6 +158,27 @@
|
||||
<artifactId>maven-jar-plugin</artifactId>
|
||||
<version>3.5.1</version>
|
||||
</plugin>
|
||||
<!-- Javadoc: генерация только по явной цели javadoc:javadoc
|
||||
(объявлен без executions в wordpdf-core) — поведение
|
||||
mvn clean verify не затрагивает. -->
|
||||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-javadoc-plugin</artifactId>
|
||||
<version>${maven-javadoc-plugin.version}</version>
|
||||
<configuration>
|
||||
<encoding>UTF-8</encoding>
|
||||
<doclint>all,-missing</doclint>
|
||||
<show>protected</show>
|
||||
<nohelp>true</nohelp>
|
||||
<windowtitle>wordpdf-core API</windowtitle>
|
||||
<doctitle>wordpdf-core API (javadoc)</doctitle>
|
||||
<!-- пин вывода: у 3.12.0 дефолт target/reports (параметр
|
||||
outputDirectory, поверх него плагин сам кладёт apidocs/),
|
||||
фиксируем target/site → target/site/apidocs — оттуда
|
||||
копирует задача docs-deploy -->
|
||||
<outputDirectory>${project.build.directory}/site</outputDirectory>
|
||||
</configuration>
|
||||
</plugin>
|
||||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-pmd-plugin</artifactId>
|
||||
|
||||
Reference in New Issue
Block a user