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.