summaryrefslogtreecommitdiffstats
path: root/Help/command/if.rst
diff options
context:
space:
mode:
authorMichael Hirsch, Ph.D <michael@scivision.dev>2021-01-26 02:14:43 (GMT)
committerBrad King <brad.king@kitware.com>2021-01-26 14:50:01 (GMT)
commite63e83d2b8478ffa71891cffe61df70c97416f79 (patch)
tree86213087597da82612df00171f2a17831c50ba53 /Help/command/if.rst
parent4f9228a3001dd104a19c5eced3dcb36eef7102f4 (diff)
downloadCMake-e63e83d2b8478ffa71891cffe61df70c97416f79.zip
CMake-e63e83d2b8478ffa71891cffe61df70c97416f79.tar.gz
CMake-e63e83d2b8478ffa71891cffe61df70c97416f79.tar.bz2
Help: Document that if(EXISTS) does not expand ~
Fixes: #21729
Diffstat (limited to 'Help/command/if.rst')
-rw-r--r--Help/command/if.rst7
1 files changed, 4 insertions, 3 deletions
diff --git a/Help/command/if.rst b/Help/command/if.rst
index c51d2bc..5dabe00 100644
--- a/Help/command/if.rst
+++ b/Help/command/if.rst
@@ -119,9 +119,10 @@ File Operations
``if(EXISTS path-to-file-or-directory)``
True if the named file or directory exists. Behavior is well-defined
- only for full paths. Resolves symbolic links, i.e. if the named file or
- directory is a symbolic link, returns true if the target of the
- symbolic link exists.
+ only for explicit full paths (a leading ``~/`` is not expanded as
+ a home directory and is considered a relative path).
+ Resolves symbolic links, i.e. if the named file or directory is a
+ symbolic link, returns true if the target of the symbolic link exists.
``if(file1 IS_NEWER_THAN file2)``
True if ``file1`` is newer than ``file2`` or if one of the two files doesn't