diff --git a/Source/cmTryCompileCommand.h b/Source/cmTryCompileCommand.h index 0c67a8ba4..9923d03b7 100644 --- a/Source/cmTryCompileCommand.h +++ b/Source/cmTryCompileCommand.h @@ -77,14 +77,20 @@ public: "Specify COPY_FILE to get a copy of the linked executable at the " "given fileName." "\n" - "In this version all files in bindir/CMakeFiles/CMakeTmp, " - "will be cleaned automatically, for debugging a --debug-trycompile can " - "be passed to cmake to avoid the clean. Some extra flags that " - " can be included are, " + "In this version all files in bindir/CMakeFiles/CMakeTmp " + "will be cleaned automatically. For debugging, --debug-trycompile can " + "be passed to cmake to avoid this clean. However, multiple sequential " + "try_compile operations reuse this single output directory. If you " + "use --debug-trycompile, you can only debug one try_compile call at a " + "time. The recommended procedure is to configure with cmake all the " + "way through once, then delete the cache entry associated with " + "the try_compile call of interest, and then re-run cmake again with " + "--debug-trycompile." + "\n" + "Some extra flags that can be included are, " "INCLUDE_DIRECTORIES, LINK_DIRECTORIES, and LINK_LIBRARIES. " "COMPILE_DEFINITIONS are -Ddefinition that will be passed to the " "compile line. " - "try_compile creates a CMakeList.txt " "file on the fly that looks like this:\n" " add_definitions(