diff options
| author | Brad King <brad.king@kitware.com> | 2013-10-04 19:34:11 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2013-10-16 13:22:38 (GMT) |
| commit | 97e8650d7bd213e5fde721a0f7d71b63ac238370 (patch) | |
| tree | e159b4dd848a8a4e25027b479194b82dc7330bfb /Help/prop_sf | |
| parent | 898216137a184940867a1678b07ca8470b2d7b85 (diff) | |
| download | CMake-97e8650d7bd213e5fde721a0f7d71b63ac238370.zip CMake-97e8650d7bd213e5fde721a0f7d71b63ac238370.tar.gz CMake-97e8650d7bd213e5fde721a0f7d71b63ac238370.tar.bz2 | |
Help: Factor out COMPILE_DEFINITIONS disclaimer duplication
The COMPILE_DEFINITIONS escaping disclaimer was represented in builtin
documentation using a preprocessor macro. Factor the duplicate content
out into a separate .txt file and include it in each document with the
reStructuredText include directive.
Diffstat (limited to 'Help/prop_sf')
| -rw-r--r-- | Help/prop_sf/COMPILE_DEFINITIONS.rst | 21 |
1 files changed, 1 insertions, 20 deletions
diff --git a/Help/prop_sf/COMPILE_DEFINITIONS.rst b/Help/prop_sf/COMPILE_DEFINITIONS.rst index 334b158..7f7e7c7 100644 --- a/Help/prop_sf/COMPILE_DEFINITIONS.rst +++ b/Help/prop_sf/COMPILE_DEFINITIONS.rst @@ -17,23 +17,4 @@ by the native build tool. The VS6 IDE does not support definition values with spaces (but NMake does). Xcode does not support per-configuration definitions on source files. -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. +.. include:: /include/COMPILE_DEFINITIONS_DISCLAIMER.txt |