This is an automated email from the ASF dual-hosted git repository.
slachiewicz 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 3246680f Correct outdated statements in the guides and the settings
reference
3246680f is described below
commit 3246680f4af2b10d411be594542a0cacb2fb6634
Author: Sylwester Lachiewicz <[email protected]>
AuthorDate: Mon Nov 2 00:43:55 2026 +0000
Correct outdated statements in the guides and the settings reference
---
content/markdown/guides/getting-started/index.md | 3 ++-
.../markdown/guides/getting-started/maven-in-five-minutes.md | 2 +-
content/markdown/guides/mini/guide-configuring-maven.md | 2 +-
.../markdown/guides/mini/guide-deployment-security-settings.md | 2 +-
content/markdown/guides/mini/guide-migration-to-mvn4.md | 2 +-
content/markdown/guides/mini/guide-multiple-modules.md | 2 +-
content/markdown/install.md.vm | 7 +++----
content/markdown/issue-management.md | 2 +-
content/markdown/plugin-developers/index.md | 1 -
content/markdown/plugins/index.md | 2 +-
content/markdown/repository/central-metadata.md | 2 +-
content/markdown/settings.md | 10 +++++-----
12 files changed, 18 insertions(+), 19 deletions(-)
diff --git a/content/markdown/guides/getting-started/index.md
b/content/markdown/guides/getting-started/index.md
index e49f009b..95656d36 100644
--- a/content/markdown/guides/getting-started/index.md
+++ b/content/markdown/guides/getting-started/index.md
@@ -329,8 +329,9 @@ Upon executing this command you should see the following
output:
Note that the surefire plugin (which executes the test) looks for tests
contained in files with a particular naming convention. By default the tests
included are:
-- `**/*Test.java`
- `**/Test*.java`
+- `**/*Test.java`
+- `**/*Tests.java`
- `**/*TestCase.java`
And the default excludes are:
diff --git a/content/markdown/guides/getting-started/maven-in-five-minutes.md
b/content/markdown/guides/getting-started/maven-in-five-minutes.md
index 01231dec..6bea2aed 100644
--- a/content/markdown/guides/getting-started/maven-in-five-minutes.md
+++ b/content/markdown/guides/getting-started/maven-in-five-minutes.md
@@ -21,7 +21,7 @@ under the License.
## Prerequisites
-You must understand how to install software on your computer. If you do not
know how to do this, please ask someone at your office, school, etc. or pay
someone to explain this to you. The Maven mailing lists are not the best place
to ask for this advice.
+You must understand how to install software on your computer. If you do not
know how to do this, please ask someone at your office, school, etc. The Maven
mailing lists are not the best place to ask for this advice.
## Installation
diff --git a/content/markdown/guides/mini/guide-configuring-maven.md
b/content/markdown/guides/mini/guide-configuring-maven.md
index 051f32e9..78f03911 100644
--- a/content/markdown/guides/mini/guide-configuring-maven.md
+++ b/content/markdown/guides/mini/guide-configuring-maven.md
@@ -73,7 +73,7 @@ Repositories to deploy to are defined in a project in the
`<distributionManageme
In addition, some repositories may require authorization to download from, so
the corresponding settings can be specified in a `server` element in the same
way.
-Which settings are required will depend on the type of repository you are
deploying to. As of the first release, only SCP deployments and file
deployments are supported by default, so only the following SCP configuration
is needed:
+Which settings are required will depend on the type of repository you are
deploying to: usually a `username` and `password`, or a private key for SSH, in
a `server` whose `id` matches the repository:
```xml
<settings>
diff --git a/content/markdown/guides/mini/guide-deployment-security-settings.md
b/content/markdown/guides/mini/guide-deployment-security-settings.md
index 6c2950cb..9d0e1d4d 100644
--- a/content/markdown/guides/mini/guide-deployment-security-settings.md
+++ b/content/markdown/guides/mini/guide-deployment-security-settings.md
@@ -23,7 +23,7 @@ Repositories to deploy to are defined in a project in the
`distributionManagemen
In addition, some repositories may require authorisation to download from, so
the corresponding settings can be specified in a server element in the same way.
-Which settings are required will depend on the type of repository you are
deploying to. As of the first release, only SCP deployments and file
deployments are supported by default, so only the following SCP configuration
is needed:
+Which settings are required will depend on the type of repository you are
deploying to: usually a `username` and `password`, or a private key for SSH, in
a `server` whose `id` matches the repository:
```xml
<settings>
diff --git a/content/markdown/guides/mini/guide-migration-to-mvn4.md
b/content/markdown/guides/mini/guide-migration-to-mvn4.md
index 03c66f98..27bd349f 100644
--- a/content/markdown/guides/mini/guide-migration-to-mvn4.md
+++ b/content/markdown/guides/mini/guide-migration-to-mvn4.md
@@ -114,7 +114,7 @@ Places where you might have to configure Maven 4 usage
aside installation:
If there is a dedicated Maven 4 version for used plugins, you should evaluate
updating to such a version.
You can use the [Versions Maven Plugin's `display-plugin-updates`
goal][versionpluginupdate] to check for updates.
-**Note**: Maven 4 aims to support all Maven 3.9 compatible plugins that do not
use old Maven 2 APIs. This is why we promote upgrading to latest release, and
to Maven 4 specific release only when a plugin requires definitively a Maven
4-specific update (bugfix or feature. TODO: list the few known plugins
requiring 4.x, either to benefit from new features like Compiler, or fix bugs
that cannot be fixed with Maven 3)
+**Note**: Maven 4 aims to support all Maven 3.9 compatible plugins that do not
use old Maven 2 APIs. This is why we promote upgrading to latest release, and
to Maven 4 specific release only when a plugin requires definitively a Maven
4-specific update (bugfix or feature)
## Troubleshooting and required changes if situation applies
diff --git a/content/markdown/guides/mini/guide-multiple-modules.md
b/content/markdown/guides/mini/guide-multiple-modules.md
index c2dfd535..4ddb2176 100644
--- a/content/markdown/guides/mini/guide-multiple-modules.md
+++ b/content/markdown/guides/mini/guide-multiple-modules.md
@@ -19,7 +19,7 @@ under the License.
# Guide to Working with Multiple Modules
-(If you're working with Maven 4, please refer to the [Maven 4 edition of this
guide](./guide-multiple-modules-4.html))
+(If you're working with Maven 4, please refer to the [Maven 4 edition of this
guide](./guide-multiple-subprojects-4.html))
As seen in the introduction to the POM, Maven supports
[project](/glossary.html#Project) aggregation in addition to project
inheritance. This section outlines how Maven processes projects with multiple
modules, and how you can work with them more effectively.
diff --git a/content/markdown/install.md.vm b/content/markdown/install.md.vm
index d80ea90e..b5f65c07 100644
--- a/content/markdown/install.md.vm
+++ b/content/markdown/install.md.vm
@@ -49,10 +49,9 @@ the `PATH` environment variable
```
Apache Maven ${currentStableVersion} (${currentStableVersionDetails})
Maven home: /opt/apache-maven-${currentStableVersion}
-Java version: 1.8.0_45, vendor: Oracle Corporation
-Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/jre
-Default locale: en_US, platform encoding: UTF-8
-OS name: "mac os x", version: "10.8.5", arch: "x86_64", family: "mac"
+Java version: 21.0.12.1, vendor: Ubuntu, runtime:
/usr/lib/jvm/java-21-openjdk-arm64
+Default locale: en, platform encoding: UTF-8, time zone: Etc/UTC
+OS name: "linux", version: "7.0.0-1013-oracle", arch: "aarch64", family: "unix"
```
That’s it! Maven is now installed.
diff --git a/content/markdown/issue-management.md
b/content/markdown/issue-management.md
index 3bb0e9ad..e47c6c90 100644
--- a/content/markdown/issue-management.md
+++ b/content/markdown/issue-management.md
@@ -44,4 +44,4 @@ issue management systems depending on which component is
involved:
* Wagon: <https://github.com/apache/maven-wagon/issues>
-or for Central Repository: <https://issues.sonatype.org/browse/MVNCENTRAL>
+or for Central Repository: <https://central.sonatype.org/faq/get-support/>
diff --git a/content/markdown/plugin-developers/index.md
b/content/markdown/plugin-developers/index.md
index 9e8f8608..36b2a9d4 100644
--- a/content/markdown/plugin-developers/index.md
+++ b/content/markdown/plugin-developers/index.md
@@ -31,7 +31,6 @@ This documentation centre is for those who are developing
Maven plugins. This mi
- [Your First Report
Mojo](../guides/plugin/guide-java-report-plugin-development.html) - Learn how
to write your first reporting plugin
- [Writing Plugin
Documentation](../guides/development/guide-plugin-documentation.html) - Learn
how to write documentation for your plugin
- [Testing your Plugin](./plugin-testing.html) - How to write tests for your
plugins
-- TODO: creating and using custom packaging (like [`maven-archetype`
packaging](/archetype/archetype-packaging/))
- [Common Bugs and Pitfalls](./common-bugs.html) - Overview of problematic
coding patterns
<!--TODO: trails-->
diff --git a/content/markdown/plugins/index.md
b/content/markdown/plugins/index.md
index 7cc6444b..0f568df2 100644
--- a/content/markdown/plugins/index.md
+++ b/content/markdown/plugins/index.md
@@ -142,7 +142,7 @@ Here are a few common ones:
| [ `native`](https://www.mojohaus.org/maven-native/native-maven-plugin/)
| Compiles C and C++ code with native compilers.
|
| [ `sql`](https://www.mojohaus.org/sql-maven-plugin/)
| Executes SQL scripts from files or inline.
|
| [ `taglist`](https://www.mojohaus.org/taglist-maven-plugin/)
| Generate a list of tasks based on tags in your code.
|
-| [ `versions`](https://www.mojohaus.org/versions-maven-plugin/)
| Manage versions of your project, its modules, dependencies and
plugins. |
+| [ `versions`](https://www.mojohaus.org/versions/versions-maven-plugin/)
| Manage versions of your project, its modules, dependencies and
plugins. |
### Misc
diff --git a/content/markdown/repository/central-metadata.md
b/content/markdown/repository/central-metadata.md
index a1abae63..68af62f9 100644
--- a/content/markdown/repository/central-metadata.md
+++ b/content/markdown/repository/central-metadata.md
@@ -31,7 +31,7 @@ You need to contact the original publisher of the metadata to
make sure in next
## Other Issues
-For any other types of issues related to metadata in the repository (POM
related, or [`maven-metadata.xml`](/ref/current/maven-repository-metadata/), or
anything else), open an issue at
[MVNCENTRAL](https://issues.sonatype.org/browse/MVNCENTRAL) with the relevant
information and explain the reasons why it is an issue.
+For any other types of issues related to metadata in the repository (POM
related, or [`maven-metadata.xml`](/ref/current/maven-repository-metadata/), or
anything else), contact [Central
Support](https://central.sonatype.org/faq/get-support/) with the relevant
information and explain the reasons why it is an issue.
**Important:** by default assume that we won't trust your info, so you must
provide all links to the project documentation you can to convince us that your
solution is right.
diff --git a/content/markdown/settings.md b/content/markdown/settings.md
index 2bd9e9cd..44afe147 100644
--- a/content/markdown/settings.md
+++ b/content/markdown/settings.md
@@ -159,9 +159,8 @@ information should exist on the build server in the
`settings.xml`.
- **privateKey**, **passphrase**: Like the previous two elements, this
pair specifies a path to a private key (default is
`${user.home}/.ssh/id_dsa`) and a `passphrase`, if required. The
- `passphrase` and `password` elements may be externalized in the
- future, but for now they must be set plain-text in the
- `settings.xml` file.
+ `passphrase` and `password` elements can be
+ [encrypted](./guides/mini/guide-encryption.html) instead of set in plain
text.
- **filePermissions**, **directoryPermissions**: When a repository
file or directory is created on deployment, these are the
permissions to use. The legal values of each is a three digit number
@@ -339,8 +338,9 @@ Mirror Settings](./guides/mini/guide-mirror-settings.html).
- **id**: The unique identifier for this proxy. This is used to
differentiate between `proxy` elements.
-- **active**: `true` if this proxy is active. This is useful for
- declaring a set of proxies, but only one may be active at a time.
+- **active**: `true` (the default) if this proxy is active. This is useful for
+ declaring a set of proxies; when several are active, Maven uses the first one
+ whose protocol matches.
- **protocol**, **host**, **port**: The `protocol://host:port` of the
proxy, separated into discrete elements.
- **username**, **password**: These elements appear as a pair denoting