This is an automated email from the ASF dual-hosted git repository.
mbuenger pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git
The following commit(s) were added to refs/heads/master by this push:
new ee8c08b3 Add note about non-flattening consumer POM by default (#1477)
ee8c08b3 is described below
commit ee8c08b308b18b3e69d7f510c992ab8537d8029b
Author: Matthias Bünger <[email protected]>
AuthorDate: Fri Dec 12 16:58:12 2025 +0100
Add note about non-flattening consumer POM by default (#1477)
---
content/markdown/whatsnewinmaven4.md | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/content/markdown/whatsnewinmaven4.md
b/content/markdown/whatsnewinmaven4.md
index 2e90c7c8..e57ded6b 100644
--- a/content/markdown/whatsnewinmaven4.md
+++ b/content/markdown/whatsnewinmaven4.md
@@ -67,7 +67,7 @@ article [Introduction to Maven Toolchains][8] by Maven
maintainer Maarten Mulder
### Consumer POM
-Maven 4 generates a stripped down consumer POM that removes build information
not needed by consumers, and deploys this
+Maven 4 can generate a stripped down consumer POM that removes build
information not needed by consumers, and deploys this
to the remote repository.
It does not deploy the `pom.xml` used to build the project.
@@ -81,6 +81,10 @@ The consumer POM is a **flattened** version of the build
POM, meaning:
This flattening ensures that consumers of your artifact have all the
information they need without requiring access to
parent POMs or understanding the internal structure of your multi-project
build.
+The flatten feature is disabled by default to avoid unexpected behavior and
better control of listing (transitive) dependencies in the consumer POM.
+To publish a flattened consumer POM instead of the full build POM, the user
property `maven.consumer.pom.flatten` must be set to `true`.
+User properties can be controlled using
`${session.rootDirectory}/.mvn/maven-user.properties` for a per-reactor
configuration.
+
### Model version 4.1.0
Maven 4 updates the POM version to 4.1.0 which defines the namespace
`http://maven.apache.org/POM/4.1.0`.
