This is an automated email from the ASF dual-hosted git repository.
hboutemy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-reporting-exec.git
The following commit(s) were added to refs/heads/master by this push:
new ac2d8a7 make build/pluginManagement configuration support more visible
ac2d8a7 is described below
commit ac2d8a787b3949c0506fdd6dff87117a7d6f6dfd
Author: Hervé Boutemy <[email protected]>
AuthorDate: Fri Jan 8 08:54:35 2021 +0100
make build/pluginManagement configuration support more visible
---
src/site/apt/index.apt.vm | 30 +++++++++++++++++-------------
1 file changed, 17 insertions(+), 13 deletions(-)
diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
index a291121..ce25428 100644
--- a/src/site/apt/index.apt.vm
+++ b/src/site/apt/index.apt.vm
@@ -32,16 +32,9 @@ ${project.name}
{{{./apidocs/org/apache/maven/reporting/exec/MavenReportExecutor.html}MavenReportExecutor}}
({{{./apidocs/org/apache/maven/reporting/exec/DefaultMavenReportExecutor.html}implementation}}).
- Since 1.4, the request can (and should) be populated from
- {{{/ref/current/maven-model/maven.html#class_reporting}pom's
<<<\<reporting\>>>> section}},
- injected in Mojo parameter as <<<$\{project.reporting.plugins\}>>> default
value:
+ Contrary to Maven 2.x:
-+----+
- @Parameter( defaultValue = "${esc.d}{project.reporting.plugins}", readonly
= true )
- private org.apache.maven.model.ReportPlugin[] reportingPlugins;
-+----+
-
- Contrary to Maven 2.x, report <<<\<version\>>>> explicit definition is
optional:
+ [[1]] report <<<\<version\>>>> explicit definition is optional:\
if no version is specified for a report plugin, version is determined by
[[1]] searching for the plugin in the <<<build/plugins>>> section of the
pom,
@@ -49,18 +42,29 @@ ${project.name}
[[2]] searching for the plugin in the <<<build/pluginManagement>>> section
of the pom,
[[3]] asking
{{{/ref/current/maven-core/apidocs/org/apache/maven/plugin/version/PluginVersionResolver.html}PluginVersionResolver}}
- to get a fallback version and display a warning as it's not a recommended
use.
+ to get a fallback version and display a warning as it's not a recommended
use,
[]
- Since <<<maven-reporting-exec>>> 1.2 (which is used by
<<<maven-site-plugin>>> 3.4), plugin configuration in
- <<<build/pluginManagement>>> is also injected into reports.
+ [[2]] plugin configuration from <<<build/pluginManagement>>> is also
injected into reports
+ (since Maven Reporting Executor 1.2, which is
{{{/plugins/maven-site-plugin/history.html}used by Maven Site Plugin 3.4}}).
+
+ []
* Notice on now obsolete reportPlugin format
+ Since 1.4 (used by Maven Site Plugin 3.7), the request can (and should) be
populated from
+ {{{/ref/current/maven-model/maven.html#class_reporting}pom's
<<<\<reporting\>>>> section}},
+ injected in Mojo parameter as <<<$\{project.reporting.plugins\}>>> default
value:
+
++----+
+ @Parameter( defaultValue = "${esc.d}{project.reporting.plugins}", readonly
= true )
+ private org.apache.maven.model.ReportPlugin[] reportingPlugins;
++----+
+
This section is kept to explain what happened in previous releases of the
component, but this approach has been
abandonned so far after discovering major limitations: see
-
{{{/plugins/maven-site-plugin/maven-3.html#New_Configuration_Maven_3_only_no_reports_configuration_inheritance}Maven
Site Plugin documentation}}
+
{{{/plugins-archives/maven-site-plugin-3.9.0/maven-3.html#New_Configuration_Maven_3_only_no_reports_configuration_inheritance}Maven
Site Plugin 3.9.0 documentation}}
for more details.
Report plugins can be configured in <<<\<configuration\>>>> element of
<<<maven-site-plugin>>> or any other
