summaryrefslogtreecommitdiff
path: root/Source/cmDocumentCompileDefinitions.h
blob: ef3b3e7155fb42e46cb366ab67d8fa970a8f639d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
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