[maven-apache-parent] branch master updated: MPOM-247/MPOM-263 document build prerequisites properties

[hb...@apache.org]

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 <hb...@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.
 
  []