summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-01-25 16:15:37 (GMT)
committerKitware Robot <kwrobot@kitware.com>2023-01-25 16:15:46 (GMT)
commit1d6d10cbf6642ef0c4c7cb16929e2bf63f435868 (patch)
tree29ab11752b681bb7f0f32f9a9c6345e52c48bf63 /Help
parent058f7189e19896c7ca28dfa93ff2f9dd49d1d743 (diff)
parenta1dc38a5670939a8ce8dfd99282f86d47412a98a (diff)
downloadCMake-1d6d10cbf6642ef0c4c7cb16929e2bf63f435868.zip
CMake-1d6d10cbf6642ef0c4c7cb16929e2bf63f435868.tar.gz
CMake-1d6d10cbf6642ef0c4c7cb16929e2bf63f435868.tar.bz2
Merge topic 'isdir_empty'
a1dc38a567 Help: Document behavior of if(EXISTS,IS_DIRECTORY) for empty paths Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8109
Diffstat (limited to 'Help')
-rw-r--r--Help/command/if.rst8
1 files changed, 6 insertions, 2 deletions
diff --git a/Help/command/if.rst b/Help/command/if.rst
index a57630b..684c113 100644
--- a/Help/command/if.rst
+++ b/Help/command/if.rst
@@ -165,6 +165,8 @@ File Operations
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.
+ False if the given path is an empty string.
+
``if(file1 IS_NEWER_THAN file2)``
True if ``file1`` is newer than ``file2`` or if one of the two files doesn't
exist. Behavior is well-defined only for full paths. If the file
@@ -173,10 +175,12 @@ File Operations
of a tie. This includes the case of passing the same file name for
both file1 and file2.
-``if(IS_DIRECTORY path-to-directory)``
- True if the given name is a directory. Behavior is well-defined only
+``if(IS_DIRECTORY path)``
+ True if ``path`` is a directory. Behavior is well-defined only
for full paths.
+ False if the given path is an empty string.
+
``if(IS_SYMLINK file-name)``
True if the given name is a symbolic link. Behavior is well-defined
only for full paths.