From c64d1385b763b7529a19a6f11c816339479dc3dc Mon Sep 17 00:00:00 2001 From: Brad King Date: Mon, 17 Jan 2011 08:17:38 -0500 Subject: Document COMPILE_DEFINITIONS known limitations (#11660, #11712) Some values simply cannot be escaped properly in all contexts for all native build tools. Document known limitations after the disclaimer that states so. --- Source/cmDocumentCompileDefinitions.h | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/Source/cmDocumentCompileDefinitions.h b/Source/cmDocumentCompileDefinitions.h index 3ea5746..ef3b3e7 100644 --- a/Source/cmDocumentCompileDefinitions.h +++ b/Source/cmDocumentCompileDefinitions.h @@ -20,6 +20,15 @@ "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." + "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 -- cgit v0.12