From 0eaaa863ed38ce95727e9743ca63a86ca2a7638e Mon Sep 17 00:00:00 2001 From: David Cole Date: Wed, 15 Aug 2012 19:52:21 -0400 Subject: [PATCH] CMake: Clarify the documentation for if(f1 IS_NEWER_THAN f2) ...comparison operator in the IF command. In the event of a tie, we intentionally return "true" so that dependent build operations are guaranteed to occur until one file is definitively newer than the other file. A tie means we're not sure, so return true to be on the safe side. --- Source/cmIfCommand.h | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Source/cmIfCommand.h b/Source/cmIfCommand.h index 4893a17b6..0a1fe06f3 100644 --- a/Source/cmIfCommand.h +++ b/Source/cmIfCommand.h @@ -149,7 +149,12 @@ public: " if(file1 IS_NEWER_THAN file2)\n" "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.\n" + "Behavior is well-defined only for full paths. " + "If the file time stamps are exactly the same, an " + "IS_NEWER_THAN comparison returns true, so that any dependent " + "build operations will occur in the event of a tie. " + "This includes the case of passing the same file name for both " + "file1 and file2.\n" " if(IS_DIRECTORY directory-name)\n" "True if the given name is a directory. " "Behavior is well-defined only for full paths.\n"