This is an automated email from the ASF dual-hosted git repository.
eolivelli 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 bfb208a Update configure.md (#81)
bfb208a is described below
commit bfb208a8a941678dbb0728de66bd5d46ec713ef8
Author: Bruno Borges <[email protected]>
AuthorDate: Sat Apr 27 00:53:02 2019 -0700
Update configure.md (#81)
* Update configure.md
* Update configure.md
---
content/markdown/configure.md | 20 +++++++++++++++++---
1 file changed, 17 insertions(+), 3 deletions(-)
diff --git a/content/markdown/configure.md b/content/markdown/configure.md
index c8cb2db..cef953c 100644
--- a/content/markdown/configure.md
+++ b/content/markdown/configure.md
@@ -3,22 +3,36 @@
The configuration for Apache Maven usage itself and projects built with
resides
in a number of places:
-* `MAVEN_OPTS` environment variable:
+## `MAVEN_OPTS` environment variable:
This variable contains parameters used to start up the JVM running Maven and
can
be used to supply additional options to globally to Maven. E.g. JVM memory
settings could be defined with the value `-Xms256m -Xmx512m`.
-* `settings.xml` file:
+## `settings.xml` file:
Located in USER_HOME/.m2 the settings files is designed to contain any
configuration for Maven usage across projects.
-* `.mvn` folder:
+## `.mvn` folder:
Located with in the projects top level folder, the files `maven.config` and
`extensions.xml`
contain project specific configuration for running Maven.
+### `.mvn/maven.config` file:
+
+This file allows developers to drop in parameters that will always be present
in any
+execution of `mvn <goal>` of the given project. This would make unecessary to
add
+parameters in every command-line call.
+
+For example, to always use a specific profile and demand that the build only
fails
+in the end, add the following:
+
+```
+--fail-at-end -P local-test-all-modules
+```
+
+## Other guides
The following guides contain further information to specific configuration
aspects: