echo/CMake
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Help: Clarify that if(PATH_EQUAL) does not access the filesystem

Browse Source 
Fixes: #26421
This commit is contained in:
scivision 2024-11-14 16:22:38 -05:00 committed by Brad King
parent 03e7b8cb07
commit 3530eef3fb
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Help/command/if.rst
View File

@ -390,11 +390,13 @@ Path Comparisons
.. versionadded:: 3.24
Compares the two paths component-by-component. Only if every component of
both paths match will the two paths compare equal. Multiple path separators
are effectively collapsed into a single separator, but note that backslashes
are not converted to forward slashes. No other
:ref:`path normalization <Normalization>` is performed.
Lexicographically compares two CMake paths component-by-component without
accessing the filesystem. Only if every component of both paths match will
the two paths compare equal. Multiple path separators are effectively
collapsed into a single separator, but note that backslashes are not
converted to forward slashes.
No other :ref:`path normalization <Normalization>` is performed.
Trailing slashes are preserved, thus ``/a/b`` and ``/a/b/`` are not equal.
Component-wise comparison is superior to string-based comparison due to the
handling of multiple path separators. In the following example, the