diff options
Diffstat (limited to 'cmake/modules/Doxygen.cmake')
-rw-r--r-- | cmake/modules/Doxygen.cmake | 42 |
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() |