1 2if (DOXYGEN_FOUND) 3if (LLVM_ENABLE_DOXYGEN) 4 set(abs_srcdir ${CMAKE_CURRENT_SOURCE_DIR}) 5 set(abs_builddir ${CMAKE_CURRENT_BINARY_DIR}) 6 7 if (HAVE_DOT) 8 set(DOT ${LLVM_PATH_DOT}) 9 endif() 10 11 if (LLVM_DOXYGEN_EXTERNAL_SEARCH) 12 set(enable_searchengine "YES") 13 set(searchengine_url "${LLVM_DOXYGEN_SEARCHENGINE_URL}") 14 set(enable_server_based_search "YES") 15 set(enable_external_search "YES") 16 set(extra_search_mappings "${LLVM_DOXYGEN_SEARCH_MAPPINGS}") 17 else() 18 set(enable_searchengine "NO") 19 set(searchengine_url "") 20 set(enable_server_based_search "NO") 21 set(enable_external_search "NO") 22 set(extra_search_mappings "") 23 endif() 24 25 # If asked, configure doxygen for the creation of a Qt Compressed Help file. 26 if (LLVM_ENABLE_DOXYGEN_QT_HELP) 27 set(CLANG_DOXYGEN_QCH_FILENAME "org.llvm.clang.qch" CACHE STRING 28 "Filename of the Qt Compressed help file") 29 set(CLANG_DOXYGEN_QHP_NAMESPACE "org.llvm.clang" CACHE STRING 30 "Namespace under which the intermediate Qt Help Project file lives") 31 set(CLANG_DOXYGEN_QHP_CUST_FILTER_NAME "Clang ${CLANG_VERSION}" CACHE STRING 32 "See http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-filters") 33 set(CLANG_DOXYGEN_QHP_CUST_FILTER_ATTRS "Clang,${CLANG_VERSION}" CACHE STRING 34 "See http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes") 35 set(clang_doxygen_generate_qhp "YES") 36 set(clang_doxygen_qch_filename "${CLANG_DOXYGEN_QCH_FILENAME}") 37 set(clang_doxygen_qhp_namespace "${CLANG_DOXYGEN_QHP_NAMESPACE}") 38 set(clang_doxygen_qhelpgenerator_path "${LLVM_DOXYGEN_QHELPGENERATOR_PATH}") 39 set(clang_doxygen_qhp_cust_filter_name "${CLANG_DOXYGEN_QHP_CUST_FILTER_NAME}") 40 set(clang_doxygen_qhp_cust_filter_attrs "${CLANG_DOXYGEN_QHP_CUST_FILTER_ATTRS}") 41 else() 42 set(clang_doxygen_generate_qhp "NO") 43 set(clang_doxygen_qch_filename "") 44 set(clang_doxygen_qhp_namespace "") 45 set(clang_doxygen_qhelpgenerator_path "") 46 set(clang_doxygen_qhp_cust_filter_name "") 47 set(clang_doxygen_qhp_cust_filter_attrs "") 48 endif() 49 50 option(LLVM_DOXYGEN_SVG 51 "Use svg instead of png files for doxygen graphs." OFF) 52 if (LLVM_DOXYGEN_SVG) 53 set(DOT_IMAGE_FORMAT "svg") 54 else() 55 set(DOT_IMAGE_FORMAT "png") 56 endif() 57 58 configure_file(${CMAKE_CURRENT_SOURCE_DIR}/doxygen.cfg.in 59 ${CMAKE_CURRENT_BINARY_DIR}/doxygen.cfg @ONLY) 60 61 set(abs_top_srcdir) 62 set(abs_top_builddir) 63 set(DOT) 64 set(enable_searchengine) 65 set(searchengine_url) 66 set(enable_server_based_search) 67 set(enable_external_search) 68 set(extra_search_mappings) 69 set(clang_doxygen_generate_qhp) 70 set(clang_doxygen_qch_filename) 71 set(clang_doxygen_qhp_namespace) 72 set(clang_doxygen_qhelpgenerator_path) 73 set(clang_doxygen_qhp_cust_filter_name) 74 set(clang_doxygen_qhp_cust_filter_attrs) 75 set(DOT_IMAGE_FORMAT) 76 77 add_custom_target(doxygen-clang 78 COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/doxygen.cfg 79 WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} 80 COMMENT "Generating clang doxygen documentation." VERBATIM) 81 82 if (LLVM_BUILD_DOCS) 83 add_dependencies(doxygen doxygen-clang) 84 endif() 85 86 if (NOT LLVM_INSTALL_TOOLCHAIN_ONLY) 87 install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/doxygen/html 88 DESTINATION docs/html) 89 endif() 90endif() 91endif() 92 93if (LLVM_ENABLE_SPHINX) 94 if (SPHINX_FOUND) 95 include(AddSphinxTarget) 96 if (${SPHINX_OUTPUT_HTML}) 97 add_sphinx_target(html clang) 98 add_custom_command(TARGET docs-clang-html POST_BUILD 99 COMMAND ${CMAKE_COMMAND} -E copy 100 "${CMAKE_CURRENT_SOURCE_DIR}/LibASTMatchersReference.html" 101 "${CMAKE_CURRENT_BINARY_DIR}/html/LibASTMatchersReference.html") 102 endif() 103 if (${SPHINX_OUTPUT_MAN}) 104 add_sphinx_target(man clang) 105 endif() 106 endif() 107endif() 108