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

Fixes: #26421
This commit is contained in:
scivision
2024-11-14 16:22:38 -05:00
committed by Brad King
parent 03e7b8cb07
commit 3530eef3fb

View File

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