(maven-reporting-impl) branch master updated: Replace Javadoc links the plugin descriptor cannot resolve

[slachiewicz]

This is an automated email from the ASF dual-hosted git repository.

slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-reporting-impl.git


The following commit(s) were added to refs/heads/master by this push:
     new e890917  Replace Javadoc links the plugin descriptor cannot resolve
e890917 is described below

commit e890917a563a8d1f67180cb0836eea1b44a4e36c
Author: Sylwester Lachiewicz <slachiew...@apache.org>
AuthorDate: Thu Oct 29 14:53:33 2026 +0000

    Replace Javadoc links the plugin descriptor cannot resolve
    
    Every report plugin copies AbstractMavenReport's parameter docs into its own
    descriptor, where {@link #getOutputPath} and @see SiteTool#... cannot be
    resolved and log a warning in each plugin build.
---
 src/main/java/org/apache/maven/reporting/AbstractMavenReport.java | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/main/java/org/apache/maven/reporting/AbstractMavenReport.java 
b/src/main/java/org/apache/maven/reporting/AbstractMavenReport.java
index 4b46b92..9f9d082 100644
--- a/src/main/java/org/apache/maven/reporting/AbstractMavenReport.java
+++ b/src/main/java/org/apache/maven/reporting/AbstractMavenReport.java
@@ -89,7 +89,7 @@ public abstract class AbstractMavenReport extends 
AbstractMojo implements MultiP
      *<p>
      * A plugin may use any subdirectory structure (either using a hard-coded 
name or, ideally, an additional
      * user-defined mojo parameter with a default value) to generate 
multi-page reports or external reports with the
-     * main output file (entry point) denoted by {@link #getOutputPath}.
+     * main output file (entry point) denoted by {@code getOutputPath()}.
      */
     @Parameter(defaultValue = "${project.build.directory}/reports", required = 
true)
     protected File outputDirectory;
@@ -150,9 +150,8 @@ public abstract class AbstractMavenReport extends 
AbstractMojo implements MultiP
 
     /**
      * The locale to use when the report generation is invoked directly as a 
standalone Mojo.
-     *
-     * @see SiteTool#DEFAULT_LOCALE
-     * @see SiteTool#getSiteLocales(String)
+     * The value is parsed like a locale of the Maven Site Plugin's {@code 
locales} parameter
+     * ({@code SiteTool.getSiteLocales(String)}); {@code default} means {@code 
SiteTool.DEFAULT_LOCALE}.
      */
     @Parameter(defaultValue = "default")
     protected String locale;