This is an automated email from the ASF dual-hosted git repository.
kwin pushed a commit to branch
feature/clarify-case-sensitivity-on-os-profile-activation
in repository https://gitbox.apache.org/repos/asf/maven-site.git
commit 9a9d1fe295865d059959166201bd219443fe9d2c
Author: Konrad Windszus <k...@apache.org>
AuthorDate: Wed Jun 5 16:45:15 2024 +0200
[MNG-8135] Clarify case insensitivity on the OS profile activation
---
content/apt/guides/introduction/introduction-to-profiles.apt | 4 ++--
content/apt/pom.apt.vm | 4 ++--
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/content/apt/guides/introduction/introduction-to-profiles.apt
b/content/apt/guides/introduction/introduction-to-profiles.apt
index beeca205..3b5e3c65 100644
--- a/content/apt/guides/introduction/introduction-to-profiles.apt
+++ b/content/apt/guides/introduction/introduction-to-profiles.apt
@@ -218,11 +218,11 @@ mvn groupId:artifactId:goal -P
profile-1,profile-2,?profile-3
<<<os.name>>>, <<<os.arch>>>, <<<os.version>>> and the family being derived
from those.
Each value can be prefixed with <<<!>>> to negate the matching.
- The values match if they are (not) equal to the actual String value.
+ The values match if they are (not) equal to the actual String value (<<case
insensitive>>).
All given OS conditions must match for the profile to be considered for
activation.
Since {{{https://issues.apache.org/jira/browse/MNG-5726}Maven 3.9.7}} the
value for <<<version>>> may be prefixed with <<<regex:>>>.
- In that case
{{{https://docs.oracle.com/javase/tutorial/essential/regex/}regular pattern
matching}} is applied for the version matching.
+ In that case
{{{https://docs.oracle.com/javase/tutorial/essential/regex/}regular pattern
matching}} is applied for the version matching and applied against the <<lower
case>> <<<os.version>>> value.
The actual OS values which need to match the given values are emitted when
executing <<<mvn --version>>>.
diff --git a/content/apt/pom.apt.vm b/content/apt/pom.apt.vm
index 2dde78d7..df0d3f18 100644
--- a/content/apt/pom.apt.vm
+++ b/content/apt/pom.apt.vm
@@ -2044,7 +2044,7 @@ scm:cvs:pserver:127.0.0.1:/cvs/root:my-project
* <<os>>:
The <<<os>>> element can require some operating system specific properties
having specific values.
Each value may start with <<<!>>> which means the condition is fulfilled if
the value following does <not> equal the actual value,
- otherwise the condition is fulfilled if the value equals the according
system property (or derived value).
+ otherwise the condition is fulfilled if the value equals the according
system property (or derived value). In both cases the check is <<case
insensitive>>.
* <<name>>, is matched against system property <<<os.name>>>
@@ -2054,7 +2054,7 @@ scm:cvs:pserver:127.0.0.1:/cvs/root:my-project
* <<version>>, is matched against system property <<<os.version>>>. Since
{{{https://issues.apache.org/jira/browse/MNG-5726}Maven 3.9.7}}
the value for <<<version>>> may be prefixed with <<<regex:>>>. In that
case {{{https://docs.oracle.com/javase/tutorial/essential/regex/}regular
pattern matching}}
- is applied for the version matching.
+ is applied for the version matching. Note that system property
<<<os.version>>> is converted to <<lower case>> prior to the matching.
See the maven-enforcer-plugin's
{{{/enforcer/enforcer-rules/requireOS.html}Require OS Rule}} for more details
about OS values.
