Files
CMake/Help/include/COMPILE_DEFINITIONS_DISCLAIMER.txt
Nikita Nemkin 718043b540 Help: Convert some literal blocks into tables and lists
Also, ensure that header-less tables have a top border in cmake.css.
2025-01-31 12:23:29 -05:00

21 lines
999 B
Plaintext

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.