107 lines
6.8 KiB
C
107 lines
6.8 KiB
C
/*============================================================================
|
|
CMake - Cross Platform Makefile Generator
|
|
Copyright 2000-2010 Kitware, Inc., Insight Software Consortium
|
|
|
|
Distributed under the OSI-approved BSD License (the "License");
|
|
see accompanying file Copyright.txt for details.
|
|
|
|
This software is distributed WITHOUT ANY WARRANTY; without even the
|
|
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
See the License for more information.
|
|
============================================================================*/
|
|
#ifndef cmDocumentGeneratorExpressions_h
|
|
#define cmDocumentGeneratorExpressions_h
|
|
|
|
#define CM_DOCUMENT_ADD_TEST_GENERATOR_EXPRESSIONS \
|
|
"Generator expressions are evaluated during build system generation " \
|
|
"to produce information specific to each build configuration. " \
|
|
"Valid expressions are:\n" \
|
|
" $<0:...> = empty string (ignores \"...\")\n" \
|
|
" $<1:...> = content of \"...\"\n" \
|
|
" $<CONFIG:cfg> = '1' if config is \"cfg\", else '0'\n" \
|
|
" $<CONFIGURATION> = configuration name\n" \
|
|
" $<BOOL:...> = '1' if the '...' is true, else '0'\n" \
|
|
" $<STREQUAL:a,b> = '1' if a is STREQUAL b, else '0'\n" \
|
|
" $<ANGLE-R> = A literal '>'. Used to compare " \
|
|
"strings which contain a '>' for example.\n" \
|
|
" $<COMMA> = A literal ','. Used to compare " \
|
|
"strings which contain a ',' for example.\n" \
|
|
" $<SEMICOLON> = A literal ';'. Used to prevent " \
|
|
"list expansion on an argument with ';'.\n" \
|
|
" $<JOIN:list,...> = joins the list with the content of " \
|
|
"\"...\"\n" \
|
|
" $<TARGET_NAME:...> = Marks ... as being the name of a " \
|
|
"target. This is required if exporting targets to multiple " \
|
|
"dependent export sets. The '...' must be a literal name of a " \
|
|
"target- it may not contain generator expressions.\n" \
|
|
" $<INSTALL_INTERFACE:...> = content of \"...\" when the property " \
|
|
"is exported using install(EXPORT), and empty otherwise.\n" \
|
|
" $<BUILD_INTERFACE:...> = content of \"...\" when the property " \
|
|
"is exported using export(), or when the target is used by another " \
|
|
"target in the same buildsystem. Expands to the empty string " \
|
|
"otherwise.\n" \
|
|
" $<C_COMPILER_ID> = The CMake-id of the C compiler " \
|
|
"used.\n" \
|
|
" $<C_COMPILER_ID:comp> = '1' if the CMake-id of the C " \
|
|
"compiler matches comp, otherwise '0'.\n" \
|
|
" $<CXX_COMPILER_ID> = The CMake-id of the CXX compiler " \
|
|
"used.\n" \
|
|
" $<CXX_COMPILER_ID:comp> = '1' if the CMake-id of the CXX " \
|
|
"compiler matches comp, otherwise '0'.\n" \
|
|
" $<VERSION_GREATER:v1,v2> = '1' if v1 is a version greater than " \
|
|
"v2, else '0'.\n" \
|
|
" $<VERSION_LESS:v1,v2> = '1' if v1 is a version less than v2, " \
|
|
"else '0'.\n" \
|
|
" $<VERSION_EQUAL:v1,v2> = '1' if v1 is the same version as v2, " \
|
|
"else '0'.\n" \
|
|
" $<C_COMPILER_VERSION> = The version of the C compiler used.\n" \
|
|
" $<C_COMPILER_VERSION:ver> = '1' if the version of the C " \
|
|
"compiler matches ver, otherwise '0'.\n" \
|
|
" $<CXX_COMPILER_VERSION> = The version of the CXX compiler " \
|
|
"used.\n" \
|
|
" $<CXX_COMPILER_VERSION:ver> = '1' if the version of the CXX " \
|
|
"compiler matches ver, otherwise '0'.\n" \
|
|
" $<TARGET_FILE:tgt> = main file (.exe, .so.1.2, .a)\n" \
|
|
" $<TARGET_LINKER_FILE:tgt> = file used to link (.a, .lib, .so)\n" \
|
|
" $<TARGET_SONAME_FILE:tgt> = file with soname (.so.3)\n" \
|
|
"where \"tgt\" is the name of a target. " \
|
|
"Target file expressions produce a full path, but _DIR and _NAME " \
|
|
"versions can produce the directory and file name components:\n" \
|
|
" $<TARGET_FILE_DIR:tgt>/$<TARGET_FILE_NAME:tgt>\n" \
|
|
" $<TARGET_LINKER_FILE_DIR:tgt>/$<TARGET_LINKER_FILE_NAME:tgt>\n" \
|
|
" $<TARGET_SONAME_FILE_DIR:tgt>/$<TARGET_SONAME_FILE_NAME:tgt>\n" \
|
|
"\n" \
|
|
" $<TARGET_PROPERTY:tgt,prop> = The value of the property prop " \
|
|
"on the target tgt.\n" \
|
|
"Note that tgt is not added as a dependency of the target this " \
|
|
"expression is evaluated on.\n" \
|
|
" $<TARGET_POLICY:pol> = '1' if the policy was NEW when " \
|
|
"the 'head' target was created, else '0'. If the policy was not " \
|
|
"set, the warning message for the policy will be emitted. This " \
|
|
"generator expression only works for a subset of policies.\n" \
|
|
" $<INSTALL_PREFIX> = Content of the install prefix when " \
|
|
"the target is exported via INSTALL(EXPORT) and empty otherwise.\n" \
|
|
"Boolean expressions:\n" \
|
|
" $<AND:?[,?]...> = '1' if all '?' are '1', else '0'\n" \
|
|
" $<OR:?[,?]...> = '0' if all '?' are '0', else '1'\n" \
|
|
" $<NOT:?> = '0' if '?' is '1', else '1'\n" \
|
|
"where '?' is always either '0' or '1'.\n" \
|
|
""
|
|
|
|
#define CM_DOCUMENT_COMMAND_GENERATOR_EXPRESSIONS \
|
|
CM_DOCUMENT_ADD_TEST_GENERATOR_EXPRESSIONS \
|
|
"Expressions with an implicit 'this' target:\n" \
|
|
" $<TARGET_PROPERTY:prop> = The value of the property prop on " \
|
|
"the target on which the generator expression is evaluated.\n" \
|
|
""
|
|
|
|
#define CM_DOCUMENT_LANGUAGE_GENERATOR_EXPRESSIONS \
|
|
"Language related expressions:\n" \
|
|
" $<LINK_LANGUAGE> = The link language of the target " \
|
|
"being generated.\n" \
|
|
" $<LINK_LANGUAGE:lang> = '1' if the link language of the " \
|
|
"target being generated matches lang, else '0'.\n" \
|
|
""
|
|
|
|
#endif
|