summaryrefslogtreecommitdiff
path: root/cmake/modules/Doxygen.cmake
diff options
context:
space:
mode:
Diffstat (limited to 'cmake/modules/Doxygen.cmake')
-rw-r--r--cmake/modules/Doxygen.cmake42
1 files changed, 35 insertions, 7 deletions
diff --git a/cmake/modules/Doxygen.cmake b/cmake/modules/Doxygen.cmake
index 804c217f..675c4bce 100644
--- a/cmake/modules/Doxygen.cmake
+++ b/cmake/modules/Doxygen.cmake
@@ -2,6 +2,11 @@
file(MAKE_DIRECTORY ${CMAKE_BINARY_DIR}/doc)
find_package(Doxygen)
+set_package_properties(Doxygen PROPERTIES
+ DESCRIPTION "Documentation generator"
+ URL "http://doxygen.org"
+ PURPOSE "Needed to generate the API documentation")
+
if(DOXYGEN_FOUND)
find_program(QHELPGENERATOR_EXECUTABLE qhelpgenerator)
mark_as_advanced(QHELPGENERATOR_EXECUTABLE)
@@ -9,18 +14,18 @@ if(DOXYGEN_FOUND)
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(QHELPGENERATOR DEFAULT_MSG QHELPGENERATOR_EXECUTABLE)
- set(QT_TAGS_FILE ${QT_DOC_DIR}/html/qt.tags)
+ set(QT_TAGS_FILE ${QT_DOC_DIR}/qtcore/qtcore.tags)
if(EXISTS ${QT_TAGS_FILE})
- find_package(Perl)
+ find_package(Perl QUIET)
if (NOT PERL_FOUND)
message(WARNING "Perl was not found. Qt crosslinks in uploaded docs won't be valid.")
- endif (NOT PERL_FOUND)
- else(EXISTS ${QT_TAGS_FILE})
+ endif ()
+ else()
message(WARNING "html/qt.tags not found in ${QT_DOC_DIR}. Set the QT_DOC_DIR variable to
point to its location to enable crosslinking.")
unset(QT_TAGS_FILE)
- endif(EXISTS ${QT_TAGS_FILE})
+ endif()
set(abs_top_builddir ${CMAKE_BINARY_DIR})
set(abs_top_srcdir ${CMAKE_SOURCE_DIR})
@@ -33,5 +38,28 @@ point to its location to enable crosslinking.")
set(GENERATE_XML NO)
set(GENERATE_QHP ${QHELPGENERATOR_FOUND})
configure_file(doxygen.cfg.in ${CMAKE_BINARY_DIR}/doxygen.cfg)
- add_custom_target(doxygen-doc ${DOXYGEN_EXECUTABLE} ${CMAKE_BINARY_DIR}/doxygen.cfg)
-endif(DOXYGEN_FOUND)
+ add_custom_target(doxygen-doc
+ ${DOXYGEN_EXECUTABLE} ${CMAKE_BINARY_DIR}/doxygen.cfg
+ SOURCES
+ doxygen.cfg.in
+ TelepathyQt/account-capability-filter.dox
+ TelepathyQt/and-filter.dox
+ TelepathyQt/async-model.dox
+ TelepathyQt/callbacks.dox
+ TelepathyQt/examples.dox
+ TelepathyQt/filter.dox
+ TelepathyQt/generic-capability-filter.dox
+ TelepathyQt/generic-property-filter.dox
+ TelepathyQt/groups.dox
+ TelepathyQt/main.dox
+ TelepathyQt/method-invocation-context.dox
+ TelepathyQt/not-filter.dox
+ TelepathyQt/or-filter.dox
+ TelepathyQt/shared-ptr.dox
+ )
+else()
+ # Suppress cmake policy CMP0046 warnings.
+ # This target is being used as a dependency in other targets,
+ # so it always needs to be available, even if empty.
+ add_custom_target(doxygen-doc)
+endif()