You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by el...@apache.org on 2026/07/30 20:38:34 UTC
(maven) branch master updated: docs: fix text quality issues in configuring.md and cache-configuration.md (#12638)
This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven.git
The following commit(s) were added to refs/heads/master by this push:
new 5ef86b3428 docs: fix text quality issues in configuring.md and cache-configuration.md (#12638)
5ef86b3428 is described below
commit 5ef86b3428faa463ed8b08f143a175f3ccf6de1f
Author: Elliotte Rusty Harold <el...@users.noreply.github.com>
AuthorDate: Thu Jul 30 20:38:28 2026 +0000
docs: fix text quality issues in configuring.md and cache-configuration.md (#12638)
* docs: fix text quality issues in configuring.md and cache-configuration.md
- Update phrasing from 'Contrary to... those files' to 'Unlike... these files'
- Remove possessive from 'Maven's DefaultRequestCache' for consistency
- Populate empty sections for Settings and Extensions with factual content
* Fix configuration paths and environment variable name
Corrected the reference to the Maven installation configuration path and updated the environment variable terminology.
* Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <17...@users.noreply.github.com>
* Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <17...@users.noreply.github.com>
* Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <17...@users.noreply.github.com>
* oxford comma
---------
Co-authored-by: Copilot Autofix powered by AI <17...@users.noreply.github.com>
---
src/site/markdown/cache-configuration.md | 2 +-
src/site/markdown/configuring.md | 16 ++++++++++++----
2 files changed, 13 insertions(+), 5 deletions(-)
diff --git a/src/site/markdown/cache-configuration.md b/src/site/markdown/cache-configuration.md
index 657d4ba609..8014d8401d 100644
--- a/src/site/markdown/cache-configuration.md
+++ b/src/site/markdown/cache-configuration.md
@@ -18,7 +18,7 @@ under the License.
-->
# Maven Cache Configuration Enhancement
-This document describes the enhanced cache configuration functionality in Maven's DefaultRequestCache.
+This document describes the enhanced cache configuration functionality in `DefaultRequestCache`.
## Overview
diff --git a/src/site/markdown/configuring.md b/src/site/markdown/configuring.md
index d0b4470ed8..e888345c6b 100644
--- a/src/site/markdown/configuring.md
+++ b/src/site/markdown/configuring.md
@@ -51,8 +51,8 @@ various parts of the system. The main entry point is the
`${maven.home}/conf/maven.properties` properties file. This file,
along with any other files loaded from it (see below) are called
_Maven properties files_ and are Java properties files with a
-few enhancements. Contrary to standard properties file, those files
-are UTF-8 encoded.
+few enhancements. Unlike standard properties files, these files are
+UTF-8 encoded.
### File Inclusion
@@ -90,13 +90,21 @@ from `${session.rootDirectory}/.mvn/maven-user.properties`.
## Settings
+Settings are configured in the `~/.m2/settings.xml` file (user level),
+`${session.rootDirectory}/.mvn/settings.xml` (project level), and
+`${maven.installation.conf}/settings.xml` (Maven installation level). See [Settings Reference](./api/maven-api-settings/settings.html) for details.
+
## Extensions
+Extensions allow you to add additional functionality to Maven. They are
+configured in the `~/.m2/extensions.xml` file (user level),
+`${session.rootDirectory}/.mvn/extensions.xml` (project level), and `${maven.installation.conf}/extensions.xml` (Maven installation level).
+
## Maven Command Line Arguments
Maven is a command line tool, and, as such, accepts various command
-line arguments. The `MAVEN_ARGS` environment value is used to
-provide additional arguments to Maven. Those arguments will be
+line arguments. The `MAVEN_ARGS` environment variable is used to
+provide additional arguments to Maven. These arguments will be
prepended to the actual list of command line arguments.
For example, options and goals could be defined with the value