summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2010-12-21 18:59:13 (GMT)
committerCMake Topic Stage <kwrobot@kitware.com>2010-12-21 18:59:13 (GMT)
commitb005910812db4fbee78a60a67236eeae657c4554 (patch)
tree12fea8d58d624ced0ef258055abdfc555ef0bbba
parentd89514f190df4da72f211e760fbe794dec6349bf (diff)
parent26cc29a8e284cbfc04bc30942edeb10ecbf7a158 (diff)
downloadCMake-b005910812db4fbee78a60a67236eeae657c4554.zip
CMake-b005910812db4fbee78a60a67236eeae657c4554.tar.gz
CMake-b005910812db4fbee78a60a67236eeae657c4554.tar.bz2
Merge topic 'file-GLOB-use-case-warning'
26cc29a Warn in find(GLOB) docs about bad use case (#11617)
-rw-r--r--Source/cmFileCommand.h7
1 files changed, 6 insertions, 1 deletions
diff --git a/Source/cmFileCommand.h b/Source/cmFileCommand.h
index e771092..b11dcde 100644
--- a/Source/cmFileCommand.h
+++ b/Source/cmFileCommand.h
@@ -116,7 +116,12 @@ public:
"expressions and store it into the variable. Globbing expressions "
"are similar to regular expressions, but much simpler. If RELATIVE "
"flag is specified for an expression, the results will be returned "
- "as a relative path to the given path.\n"
+ "as a relative path to the given path. "
+ "(We do not recommend using GLOB to collect a list of source files "
+ "from your source tree. If no CMakeLists.txt file changes when a "
+ "source is added or removed then the generated build system cannot "
+ "know when to ask CMake to regenerate.)"
+ "\n"
"Examples of globbing expressions include:\n"
" *.cxx - match all files with extension cxx\n"
" *.vt? - match all files with extension vta,...,vtz\n"