(maven-site) 01/01: [MNG-8135] Clarify case insensitivity on the OS profile activation

[kw...@apache.org]

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 <kw...@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.