[PATCH] Qt Creator help/documentation file for Clang

[Konrad Wilhelm Kleine]

  Hi gribozavr,

  in which place shall I document the build variables? The options and variables I've added all have a descriptions string that shows up in in the cmake-gui command.

  I ran this command:

      find . -name "CMakeLists.txt" | xargs rgrep "CLANG_[A-Z0-9_]*" -o --no-filename | sort | uniq -c | sort -n

  to get this list of CLANG_* identifiers from the CMakeLists.txt files:

        1 CLANG_DOC_QCH_FILENAME
        1 CLANG_DOC_QHELPGENERATOR_PATH
        1 CLANG_DOC_QHP_NAMESPACE
        1 CLANG_GENERATE_QHP
        1 CLANG_RESOURCE_DIR
        1 CLANG_TOOLS_BINARY_DIR
        1 CLANG_TOOLS_EXTRA_SOURCE_DIR
        1 CLANG_TOOLS_SOURCE_DIR
        1 CLANG_VERSION_PATCHLEVEL
        2 CLANG_BINARY_DIR
        2 CLANG_BUILD_STATIC
        2 CLANG_DOC_GENERATE_QCH
        2 CLANG_DOC_GENERATE_QHP
        2 CLANG_EXAMPLES
        2 CLANG_FORMAT_VS_PLUGIN
        2 CLANG_GENERATE_QCH
        2 CLANG_HAS_VERSION_PATCHLEVEL
        2 CLANG_HAVE_LIBXML
        2 CLANG_INCLUDE_DOCS
        2 CLANG_INCLUDE_TESTS
        2 CLANG_LINT_SOURCE_DIR
        2 CLANG_MODERNIZE_SOURCE_DIR
        2 CLANG_TEST_USE_VG
        2 CLANG_TOOLS_DIR
        2 CLANG_TOOLS_TEST_DEPS
        2 CLANG_TOOLS_TEST_EXTRA_ARGS
        2 CLANG_TOOLS_TEST_USE_VG
        2 CLANG_VENDOR_UTI
        3 CLANG_BUILD_EXAMPLES
        3 CLANG_BUILT_STANDALONE
        3 CLANG_EXECUTABLE_VERSION
        3 CLANG_ORDER_FILE
        3 CLANG_TEST_PARAMS
        3 CLANG_VERSION_MAJOR
        3 CLANG_VERSION_MINOR
        4 CLANG_LIBRARY_VERSION
        4 CLANG_LINK_FLAGS
        4 CLANG_REPOSITORY_STRING
        4 CLANG_TABLEGEN_TARGETS
        4 CLANG_TEST_EXTRA_ARGS
        5 CLANG_TEST_DEPS
        6 CLANG_VENDOR
        8 CLANG_ENABLE_ARCMT
        8 CLANG_ENABLE_REWRITER
       10 CLANG_ENABLE_STATIC_ANALYZER
       11 CLANG_VERSION
       12 CLANG_SOURCE_DIR

  When I search for one of them, they only occur in CMakeLists.txt files themselves. For example:

      grep "CLANG_ENABLE_ARCMT" . -r --context=5

  And in the context ofr 5 lines before and after the match I couldn't find any more documentation than the description that I've added as well.

  This isn't meant as an excuse but I'd really like to know in what other places to the build parameters.

http://llvm-reviews.chandlerc.com/D2965