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 <hbout...@apache.org> 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