1 files changed, 34 insertions, 0 deletions
diff --git a/Source/cmDocumentCompileDefinitions.h b/Source/cmDocumentCompileDefinitions.h
new file mode 100644
index 000000000..ef3b3e715
--- /dev/null
+++ b/Source/cmDocumentCompileDefinitions.h
@@ -0,0 +1,34 @@
+/*============================================================================
+  CMake - Cross Platform Makefile Generator
+  Copyright 2000-2011 Kitware, Inc., Insight Software Consortium
+
+  Distributed under the OSI-approved BSD License (the "License");
+  see accompanying file Copyright.txt for details.
+
+  This software is distributed WITHOUT ANY WARRANTY; without even the
+  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the License for more information.
+============================================================================*/
+#ifndef cmDocumentCompileDefinitions_h
+#define cmDocumentCompileDefinitions_h
+
+#define CM_DOCUMENT_COMPILE_DEFINITIONS_DISCLAIMER \
+  "Disclaimer: Most native build tools have poor support for escaping " \
+  "certain values.  CMake has work-arounds for many cases but some "    \
+  "values may just not be possible to pass correctly.  If a value "     \
+  "does not seem to be escaped correctly, do not attempt to "           \
+  "work-around the problem by adding escape sequences to the value.  "  \
+  "Your work-around may break in a future version of CMake that "       \
+  "has improved escape support.  Instead consider defining the macro "  \
+  "in a (configured) header file.  Then report the limitation.  "       \
+  "Known limitations include:\n"                                        \
+  "  #          - broken almost everywhere\n"                           \
+  "  ;          - broken in VS IDE and Borland Makefiles\n"             \
+  "  ,          - broken in VS IDE\n"                                   \
+  "  %          - broken in some cases in NMake\n"                      \
+  "  & |        - broken in some cases on MinGW\n"                      \
+  "  ^ < > \\\"   - broken in most Make tools on Windows\n"             \
+  "CMake does not reject these values outright because they do work "   \
+  "in some cases.  Use with caution.  "
+
+#endif