https://github.com/Kitware/CMake
Raw File
Tip revision: d5401de605af11ad3cd1c6faa64bf319af6b67c6 authored by Brad King on 15 February 2021, 16:48:33 UTC
CMake 3.19.5
Tip revision: d5401de
COMPILE_DEFINITIONS_DISCLAIMER.txt
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::

  #          - broken almost everywhere
  ;          - broken in VS IDE 7.0 and Borland Makefiles
  ,          - broken in VS IDE
  %          - broken in some cases in NMake
  & |        - broken in some cases on MinGW
  ^ < > \"   - broken in most Make tools on Windows

CMake does not reject these values outright because they do work in
some cases.  Use with caution.
back to top