cmDocumentGeneratorExpressions.h 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. /*============================================================================
  2. CMake - Cross Platform Makefile Generator
  3. Copyright 2000-2010 Kitware, Inc., Insight Software Consortium
  4. Distributed under the OSI-approved BSD License (the "License");
  5. see accompanying file Copyright.txt for details.
  6. This software is distributed WITHOUT ANY WARRANTY; without even the
  7. implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  8. See the License for more information.
  9. ============================================================================*/
  10. #ifndef cmDocumentGeneratorExpressions_h
  11. #define cmDocumentGeneratorExpressions_h
  12. #define CM_DOCUMENT_COMMAND_GENERATOR_EXPRESSIONS \
  13. "Generator expressions are evaluted during build system generation " \
  14. "to produce information specific to each build configuration. " \
  15. "Valid expressions are:\n" \
  16. " $<0:...> = empty string (ignores \"...\")\n" \
  17. " $<1:...> = content of \"...\"\n" \
  18. " $<CONFIG:cfg> = '1' if config is \"cfg\", else '0'\n" \
  19. " $<CONFIGURATION> = configuration name\n" \
  20. " $<BOOL:...> = '1' if the '...' is true, else '0'\n" \
  21. " $<STREQUAL:a,b> = '1' if a is STREQUAL b, else '0'\n" \
  22. " $<ANGLE-R> = A literal '>'. Used to compare " \
  23. "strings which contain a '>' for example.\n" \
  24. " $<COMMA> = A literal ','. Used to compare " \
  25. "strings which contain a ',' for example.\n" \
  26. " $<TARGET_FILE:tgt> = main file (.exe, .so.1.2, .a)\n" \
  27. " $<TARGET_LINKER_FILE:tgt> = file used to link (.a, .lib, .so)\n" \
  28. " $<TARGET_SONAME_FILE:tgt> = file with soname (.so.3)\n" \
  29. "where \"tgt\" is the name of a target. " \
  30. "Target file expressions produce a full path, but _DIR and _NAME " \
  31. "versions can produce the directory and file name components:\n" \
  32. " $<TARGET_FILE_DIR:tgt>/$<TARGET_FILE_NAME:tgt>\n" \
  33. " $<TARGET_LINKER_FILE_DIR:tgt>/$<TARGET_LINKER_FILE_NAME:tgt>\n" \
  34. " $<TARGET_SONAME_FILE_DIR:tgt>/$<TARGET_SONAME_FILE_NAME:tgt>\n" \
  35. "Boolean expressions:\n" \
  36. " $<AND:?[,?]...> = '1' if all '?' are '1', else '0'\n" \
  37. " $<OR:?[,?]...> = '0' if all '?' are '0', else '1'\n" \
  38. " $<NOT:?> = '0' if '?' is '1', else '1'\n" \
  39. "where '?' is always either '0' or '1'.\n" \
  40. ""
  41. #endif