blob: 883e3074275a34dc13cbe3f66aa222b356b85484 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
# Generate documentation
option(BUILD_DEVELOPER_DOCS "Include developer documentation" OFF)
add_feature_info("Include developer documentation" BUILD_DEVELOPER_DOCS "")
function(_find_all_includes _ret_includes _ret_framework_paths)
set(_all_includes "${PROJECT_SOURCE_DIR}/src/plugins;${PROJECT_SOURCE_DIR}/src/libs")
foreach(_target ${__QTC_PLUGINS} ${__QTC_LIBRARIES})
if (NOT TARGET ${_target})
continue()
endif()
get_target_property(_includes ${_target} INCLUDE_DIRECTORIES)
foreach(_include ${_includes})
string(FIND "${_include}" "/src/plugins/" _in_plugins)
string(FIND "${_include}" "/src/libs/" _in_libs)
string(FIND "${_include}" "${CMAKE_BINARY_DIR}" _in_build)
string(REGEX MATCH "\\$<TARGET_PROPERTY:([^,]+).*>" _property_match "${_include}")
set(_property_target "${CMAKE_MATCH_1}")
if(_in_plugins LESS 0 AND _in_libs LESS 0 AND _in_build LESS 0 AND (NOT _property_target OR TARGET ${_property_target}))
list(APPEND _all_includes ${_include})
endif()
endforeach()
endforeach()
list(APPEND _all_includes ${CMAKE_CXX_IMPLICIT_INCLUDE_DIRECTORIES})
list(REMOVE_DUPLICATES _all_includes)
set("${_ret_includes}" "${_all_includes}" PARENT_SCOPE)
# framework path
if (APPLE)
get_target_property(_qt_type Qt::Core TYPE)
if ("${_qt_type}" STREQUAL "INTERFACE_LIBRARY")
# version-less target Qt::Core is an interface library that links to QtX::Core
get_target_property(_qt_core Qt::Core INTERFACE_LINK_LIBRARIES)
else()
set(_qt_core "Qt::Core")
endif()
get_target_property(_qt_target ${_qt_core} LOCATION)
# eg <fw_path>/QtCore.framework/QtCore
# or <fw_path>/QtCore.framework/Versions/A/QtCore
# cut off /QtCore.framework/*
string(REGEX REPLACE "/QtCore.framework/.*" "" _qt_loc "${_qt_target}")
set("${_ret_framework_paths}" "${_qt_loc}" PARENT_SCOPE)
endif()
endfunction()
function(_add_doc _doc_file _dev_doc_file)
set(GENERATED_ATTRIBUTIONS_DIR ${CMAKE_CURRENT_BINARY_DIR}/generated_attributions)
add_qtc_documentation(${_doc_file}
ENVIRONMENT_EXPORTS GENERATED_ATTRIBUTIONS_DIR
)
set(attribution_src "${CMAKE_CURRENT_SOURCE_DIR}/../qt_attributions.json")
set(attribution_dest "${CMAKE_CURRENT_BINARY_DIR}/qt_attributions.json")
qtc_prepare_attribution_file("${attribution_src}" "${attribution_dest}")
add_qtc_doc_attribution(doc_attributions
"${attribution_dest}"
"${GENERATED_ATTRIBUTIONS_DIR}/creator-attributions.qdoc"
${_doc_file}
)
if (Qt6_VERSION VERSION_GREATER_EQUAL 6.8.0)
set(litehtml_attributions "${CMAKE_CURRENT_SOURCE_DIR}/../src/libs/qlitehtml/src/3rdparty/qt_attribution.json")
if(EXISTS "${litehtml_attributions}")
add_qtc_doc_attribution(doc_attributions_litehtml
"${litehtml_attributions}"
"${GENERATED_ATTRIBUTIONS_DIR}/creator-attributions-litehtml.qdoc"
${_doc_file}
)
endif()
else()
message(WARNING "Disabling qt_attribution.json handling for qlitehtml for Qt < 6.8.0")
endif()
if (BUILD_DEVELOPER_DOCS)
_find_all_includes(_all_includes _framework_paths)
add_qtc_documentation(${_dev_doc_file}
INCLUDE_DIRECTORIES ${_all_includes}
FRAMEWORK_PATHS ${_framework_paths}
)
endif()
endfunction()
if (WITH_DOCS)
_add_doc(${IDE_DOC_FILE} "qtcreatordev/qtcreator-dev.qdocconf")
endif()
if(WITH_ONLINE_DOCS)
_add_doc(${IDE_DOC_FILE_ONLINE} "qtcreatordev/qtcreator-dev-online.qdocconf")
endif()
if (BUILD_DOCS_BY_DEFAULT)
set(EXCLUDE_DOCS_FROM_ALL "")
else()
set(EXCLUDE_DOCS_FROM_ALL "EXCLUDE_FROM_ALL")
endif()
install(DIRECTORY config
DESTINATION ${IDE_HEADER_INSTALL_PATH}/doc
COMPONENT Devel
${EXCLUDE_DOCS_FROM_ALL}
)
|
