summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorMarc Chevrier <marc.chevrier@gmail.com>2022-05-28 10:26:05 (GMT)
committerMarc Chevrier <marc.chevrier@gmail.com>2022-06-01 13:28:54 (GMT)
commit4d1883df1142fbe5c23cb7f433f619c1a7322984 (patch)
tree6f066361f28b28e1700aa28d2aa78885bb136de6 /Help
parentf3be15e4382c17d0441a4fa69f44482d888e9c9d (diff)
downloadCMake-4d1883df1142fbe5c23cb7f433f619c1a7322984.zip
CMake-4d1883df1142fbe5c23cb7f433f619c1a7322984.tar.gz
CMake-4d1883df1142fbe5c23cb7f433f619c1a7322984.tar.bz2
Genex-PATH_EQUAL: path comparison
To complete issue #23498
Diffstat (limited to 'Help')
-rw-r--r--Help/command/cmake_path.rst1
-rw-r--r--Help/manual/cmake-generator-expressions.7.rst13
-rw-r--r--Help/release/dev/Genex-PATH_EQUAL.rst5
3 files changed, 19 insertions, 0 deletions
diff --git a/Help/command/cmake_path.rst b/Help/command/cmake_path.rst
index 77525ed..6fd3cf6 100644
--- a/Help/command/cmake_path.rst
+++ b/Help/command/cmake_path.rst
@@ -473,6 +473,7 @@ are :ref:`normalized <Normalization>` before the check.
set(path "/a/b")
cmake_path(IS_PREFIX path "/a/c/../b" NORMALIZE result) # result = true
+.. _Path COMPARE:
.. _COMPARE:
::
diff --git a/Help/manual/cmake-generator-expressions.7.rst b/Help/manual/cmake-generator-expressions.7.rst
index 1f0dd59..03821ec 100644
--- a/Help/manual/cmake-generator-expressions.7.rst
+++ b/Help/manual/cmake-generator-expressions.7.rst
@@ -123,6 +123,19 @@ String Comparisons
``1`` if ``v1`` is a version greater than or equal to ``v2``, else ``0``.
+Path Comparisons
+----------------
+
+.. genex:: $<PATH_EQUAL:path1,path2>
+
+ .. versionadded:: 3.24
+
+ Compares the lexical representations of two paths. No normalization is
+ performed on either path. Returns ``1`` if the paths are equal, ``0``
+ otherwise.
+
+ See :ref:`cmake_path(COMPARE) <Path COMPARE>` for more details.
+
.. _GenEx Path Queries:
Path Queries
diff --git a/Help/release/dev/Genex-PATH_EQUAL.rst b/Help/release/dev/Genex-PATH_EQUAL.rst
new file mode 100644
index 0000000..953ac26
--- /dev/null
+++ b/Help/release/dev/Genex-PATH_EQUAL.rst
@@ -0,0 +1,5 @@
+Genex-PATH_EQUAL
+----------------
+
+* The :genex:`PATH_EQUAL` generator expression was added to manage path
+ comparisons.