Documentation: Clarify some command descriptions

- file(WRITE): add configure_file() decoupling hint
- function(): definitely mention PARENT_SCOPE
- include_directories(): mention possible results of SYSTEM setting
- macro(): mention scope specifics of function()
- message(): improve SEND_ERROR / FATAL_ERROR docs, since people said it's not obvious

1 files changed, 2 insertions, 0 deletions

diff --git a/Source/cmFunctionCommand.h b/Source/cmFunctionCommand.h
index 0c0fd26..0a029dc 100644
--- a/Source/cmFunctionCommand.h
+++ b/Source/cmFunctionCommand.h
@@ -92,6 +92,8 @@ public:
       "ARGV holds the list of all arguments given to the function and ARGN "
       "holds the list of arguments past the last expected argument."
       "\n"
+      "A function opens a new scope: see set(var PARENT_SCOPE) for details."
+      "\n"
       "See the cmake_policy() command documentation for the behavior of "
       "policies inside functions."
       ;