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-apache-parent.git
The following commit(s) were added to refs/heads/master by this push:
new 9b5300e MPOM-247/MPOM-263 document build prerequisites properties
9b5300e is described below
commit 9b5300e9a5d61acc282ac5b4c649d80ce4221323
Author: Hervé Boutemy <hbout...@apache.org>
AuthorDate: Thu Jun 17 08:25:07 2021 +0200
MPOM-247/MPOM-263 document build prerequisites properties
---
src/site-docs/apt/index.apt.vm | 21 ++++++++++++++-------
1 file changed, 14 insertions(+), 7 deletions(-)
diff --git a/src/site-docs/apt/index.apt.vm b/src/site-docs/apt/index.apt.vm
index 84b52c5..4ca17fb 100644
--- a/src/site-docs/apt/index.apt.vm
+++ b/src/site-docs/apt/index.apt.vm
@@ -60,14 +60,13 @@ Apache Software Foundation Parent POM
** <<mailingLists>>: The POM sets up generic Apache announcement
lists. You should override this.
-
+
* <<pluginManagement>>: The plugin management section specifies versions
of a list of plugins. See the {{{./plugin-management.html}Plugin
Management report}} for
the complete list with versions.
- ** The compiler plugin is set to default to <<Java
$context.get("maven.compiler.source")>> and
$context.get("project.build.sourceEncoding") source.
-
- Notice that some plugins require Java 8 to run.
+ ** The compiler plugin is set to default to <<Java
$context.get("maven.compiler.target")>> (<<<maven.compiler.target>>> property)
+ and $context.get("project.build.sourceEncoding") source
(<<<project.build.sourceEncoding>>> property).
** The jar plugin is set to add default specification and implementation
entries.
@@ -79,24 +78,32 @@ Apache Software Foundation Parent POM
\<useReleaseProfiles\>. You can remove this with an empty
\<arguments/\> element in the configuration of the release plugin.
- * <<plugins>>: The plugins section configures two executions:
+ * <<plugins>>: The plugins section configures three executions:
** maven-remote-resources-plugin for
{{{/apache-resource-bundles/}org.apache:apache-jar-resource-bundle:1.4}}.
** maven-site-plugin:attach-descriptor
+ ** maven-enforcer-plugin to check Maven and Java build prerequisites,
configured via properties:
+
+ *** <<<minimalMavenBuildVersion>>> property: default value is <<Maven
$context.get("minimalMavenBuildVersion")>>
+
+ *** <<<minimalJavaBuildVersion>>> property: default value is <<Java
$context.get("minimalJavaBuildVersion")>>
+
+ []
+
* <<Reproducible Builds>>: since version 22 of this parent POM, managed
plugins versions are expected to be compliant with
{{{https://reproducible-builds.org/}Reproducible Builds}}.
To choose the timestamp in output archives, projects using this POM as
parent should define a property in their root POM:
+------+
<properties>
-
<project.build.outputTimestamp>$context.get("project.build.outputTimestamp")</project.build.outputTimestamp>
+ <project.build.outputTimestamp>1</project.build.outputTimestamp>
</properties>
+------+
The value will be updated by Maven Release Plugin during releases. If a
project wants to disable Reproducible Builds, just define
- the property value with any single character.
+ the property value with any single non-numeric character.
[]
