Merge topic 'file-GLOB-use-case-warning'

26cc29a Warn in find(GLOB) docs about bad use case (#11617)

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"