Merge topic 'doc-try_compile-debug-advice'

abbe91c5 Help: Clarify --debug-trycompile usage with try_compile
This commit is contained in:
Brad King 2014-09-04 09:48:30 -04:00 committed by CMake Topic Stage
commit 0ad4f28fc0
1 changed files with 4 additions and 3 deletions

View File

@ -36,9 +36,10 @@ cleaned automatically. For debugging, --debug-trycompile can be
passed to cmake to avoid this clean. However, multiple sequential
try_compile operations reuse this single output directory. If you use
--debug-trycompile, you can only debug one try_compile call at a time.
The recommended procedure is to configure with cmake all the way
through once, then delete the cache entry associated with the
try_compile call of interest, and then re-run cmake again with
The recommended procedure is to protect all try_compile calls in your
project by ``if(NOT DEFINED RESULT_VAR)`` logic, configure with cmake
all the way through once, then delete the cache entry associated with
the try_compile call of interest, and then re-run cmake again with
--debug-trycompile.
Some extra flags that can be included are, INCLUDE_DIRECTORIES,