Files
CMake/Help/include/COMPILE_DEFINITIONS_DISCLAIMER.rst
Alex Turbov 9784834b4c Help: Use *.rst extension for included files
So, editor(s) can correctly highlight the RST syntax in the included files.
2025-04-14 03:07:46 +04:00

21 lines
999 B
ReStructuredText

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.