find_package(Doxygen) if(DOXYGEN_EXECUTABLE) OPTION(DBUS_ENABLE_DOXYGEN_DOCS "build DOXYGEN documentation (requires Doxygen)" ON) endif(DOXYGEN_EXECUTABLE) if (DBUS_ENABLE_DOXYGEN_DOCS) set (top_srcdir ${CMAKE_SOURCE_DIR}/..) configure_file(${CMAKE_SOURCE_DIR}/Doxyfile.cmake ${CMAKE_BINARY_DIR}/Doxyfile ) add_custom_target(doc COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_BINARY_DIR}/Doxyfile ) endif (DBUS_ENABLE_DOXYGEN_DOCS) # # find docbook generator # find_program(MEINPROC_EXECUTABLE meinproc4) find_program(XMLTO_EXECUTABLE xmlto) if (MEINPROC_EXECUTABLE OR XMLTO_EXECUTABLE) OPTION(DBUS_ENABLE_XML_DOCS "build XML documentation (requires xmlto or meinproc4)" ON) endif (MEINPROC_EXECUTABLE OR XMLTO_EXECUTABLE) if (MEINPROC_EXECUTABLE) set(DOCBOOK_GENERATOR_NAME "meinproc4" PARENT_SCOPE) set(DBUS_XML_DOCS_ENABLED 1) set(STYLESHEET "${CMAKE_INSTALL_PREFIX}/share/apps/ksgmltools2/docbook/xsl/html/docbook.xsl") endif (MEINPROC_EXECUTABLE) if (XMLTO_EXECUTABLE) set (DOCBOOK_GENERATOR_NAME "xmlto" PARENT_SCOPE) set(DBUS_XML_DOCS_ENABLED 0) MESSAGE(STATUS "xmlto docbook generator found, but xmlto doc generating needs validation") endif (XMLTO_EXECUTABLE) if (DBUS_ENABLE_XML_DOCS) macro (DOCBOOK _sources _options) get_filename_component(_infile ${_sources} REALPATH) get_filename_component(_basename ${_infile} NAME_WE) set(_outfile ${CMAKE_CURRENT_BINARY_DIR}/${_basename}.html) if (EXISTS ${_sources}) if (MEINPROC_EXECUTABLE) ADD_CUSTOM_TARGET(${_basename}.html ALL meinproc4 --stylesheet ${STYLESHEET} -o ${_outfile} ${_infile} DEPENDS ${_infile} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} ) endif () if (XMLTO_EXECUTABLE) ADD_CUSTOM_TARGET(${_basename}.html ALL xmlto.bat ${_options} ${_infile} DEPENDS ${_infile} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} ) endif () install(FILES ${_outfile} DESTINATION share/doc/dbus) else () MESSAGE(STATUS "skipping xml doc generating for ${_infile}, file not found") endif () endmacro (DOCBOOK) ### copy tests to builddir so that generated tests and static tests ### are all in one place. ### todo how to add more filetypes MACRO (COPYDIR _src _type) FOREACH(FILE_TYPE ${_type}) FOREACH(DIR ${_src}) FILE(GLOB FILES "${CMAKE_SOURCE_DIR}/../${DIR}/${FILE_TYPE}" ) FILE(MAKE_DIRECTORY ${CMAKE_BINARY_DIR}/${DIR}) FOREACH(FILE ${FILES}) GET_FILENAME_COMPONENT(FILENAME ${FILE} NAME) SET (TARGET ${CMAKE_BINARY_DIR}/${DIR}/${FILENAME}) configure_file(${FILE} ${TARGET} COPYONLY) IF (CONFIG_VERBOSE) MESSAGE("FROM: ${FILE}\nTO: ${TARGET}\n") ENDIF (CONFIG_VERBOSE) ENDFOREACH(FILE) ENDFOREACH(DIR) ENDFOREACH(FILE_TYPE) ENDMACRO (COPYDIR) COPYDIR(doc *.png) COPYDIR(doc *.svg) DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-test-plan.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-tutorial.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-specification.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-faq.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/bus/dbus-daemon.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/tools/dbus-monitor.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/tools/dbus-send.xml html-nochunks) DOCBOOK(${CMAKE_SOURCE_DIR}/tools/dbus-launch.xml html-nochunks) # # handle html index file # configure_file(${CMAKE_CURRENT_SOURCE_DIR}/index.html.cmake ${CMAKE_CURRENT_BINARY_DIR}/index.html ) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/index.html DESTINATION share/doc/dbus) set (EXTRA_DIST ${CMAKE_SOURCE_DIR}/../doc/busconfig.dtd ${CMAKE_SOURCE_DIR}/../doc/introspect.dtd ${CMAKE_SOURCE_DIR}/../doc/introspect.xsl ) install(FILES ${EXTRA_DIST} DESTINATION share/doc/dbus) endif(DBUS_ENABLE_XML_DOCS)