4
OPTION(DBUS_ENABLE_DOXYGEN_DOCS "build DOXYGEN documentation (requires Doxygen)" ON)
5
endif(DOXYGEN_EXECUTABLE)
7
if (DBUS_ENABLE_DOXYGEN_DOCS)
8
set (top_srcdir ${CMAKE_SOURCE_DIR}/..)
9
configure_file(${CMAKE_SOURCE_DIR}/Doxyfile.cmake ${CMAKE_BINARY_DIR}/Doxyfile )
11
COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_BINARY_DIR}/Doxyfile
13
endif (DBUS_ENABLE_DOXYGEN_DOCS)
16
# find docbook generator
18
find_program(MEINPROC4_EXECUTABLE meinproc4)
20
find_program(XMLTO_EXECUTABLE xmlto)
22
if (MEINPROC4_EXECUTABLE OR XMLTO_EXECUTABLE)
23
OPTION(DBUS_ENABLE_XML_DOCS "build XML documentation (requires xmlto or meinproc4)" ON)
24
endif (MEINPROC4_EXECUTABLE OR XMLTO_EXECUTABLE)
26
if (MEINPROC4_EXECUTABLE)
27
set(DOCBOOK_GENERATOR_NAME "meinproc4" PARENT_SCOPE)
28
set(DBUS_XML_DOCS_ENABLED 1)
30
get_filename_component(_a ${MEINPROC4_EXECUTABLE} PATH)
31
get_filename_component(_meinproc_install_path ${_a} PATH)
33
set(_meinproc_install_path ${CMAKE_INSTALL_PREFIX})
35
set(STYLESHEET "${_meinproc_install_path}/share/apps/ksgmltools2/docbook/xsl/html/docbook.xsl")
36
endif (MEINPROC4_EXECUTABLE)
40
set (DOCBOOK_GENERATOR_NAME "xmlto" PARENT_SCOPE)
41
set(DBUS_XML_DOCS_ENABLED 1)
42
MESSAGE(STATUS "xmlto docbook generator found")
43
endif (XMLTO_EXECUTABLE)
45
if (DBUS_ENABLE_XML_DOCS)
47
macro (DOCBOOK _sources _options)
48
get_filename_component(_infile ${_sources} ABSOLUTE)
49
get_filename_component(_basename ${_infile} NAME_WE)
50
set(_outfile ${CMAKE_CURRENT_BINARY_DIR}/${_basename}.html)
52
if (EXISTS ${_sources})
53
if (MEINPROC4_EXECUTABLE)
54
ADD_CUSTOM_TARGET(${_basename}.html ALL
55
${MEINPROC4_EXECUTABLE} --stylesheet ${STYLESHEET} -o ${_outfile} ${_infile}
57
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
61
ADD_CUSTOM_TARGET(${_basename}.html ALL
62
${XMLTO_EXECUTABLE} -vv ${_options} ${_infile}
64
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
67
install(FILES ${_outfile} DESTINATION share/doc/dbus)
69
MESSAGE(STATUS "skipping xml doc generating for ${_infile}, file not found")
74
### copy tests to builddir so that generated tests and static tests
75
### are all in one place.
76
### todo how to add more filetypes
77
MACRO (COPYDIR _src _type)
78
FOREACH(FILE_TYPE ${_type})
80
FILE(GLOB FILES "${CMAKE_SOURCE_DIR}/../${DIR}/${FILE_TYPE}" )
81
FILE(MAKE_DIRECTORY ${CMAKE_BINARY_DIR}/${DIR})
82
FOREACH(FILE ${FILES})
83
GET_FILENAME_COMPONENT(FILENAME ${FILE} NAME)
84
SET (TARGET ${CMAKE_BINARY_DIR}/${DIR}/${FILENAME})
85
configure_file(${FILE} ${TARGET} COPYONLY)
87
MESSAGE("FROM: ${FILE}\nTO: ${TARGET}\n")
88
ENDIF (CONFIG_VERBOSE)
97
DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-test-plan.xml html-nochunks)
98
DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-tutorial.xml html-nochunks)
99
DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-specification.xml html-nochunks)
100
DOCBOOK(${CMAKE_SOURCE_DIR}/../doc/dbus-faq.xml html-nochunks)
101
DOCBOOK(${CMAKE_SOURCE_DIR}/bus/dbus-daemon.xml html-nochunks)
102
DOCBOOK(${CMAKE_SOURCE_DIR}/tools/dbus-monitor.xml html-nochunks)
103
DOCBOOK(${CMAKE_SOURCE_DIR}/tools/dbus-send.xml html-nochunks)
104
DOCBOOK(${CMAKE_SOURCE_DIR}/tools/dbus-launch.xml html-nochunks)
107
# handle html index file
109
configure_file(${CMAKE_CURRENT_SOURCE_DIR}/index.html.cmake ${CMAKE_CURRENT_BINARY_DIR}/index.html )
110
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/index.html DESTINATION share/doc/dbus)
113
${CMAKE_SOURCE_DIR}/../doc/busconfig.dtd
114
${CMAKE_SOURCE_DIR}/../doc/introspect.dtd
115
${CMAKE_SOURCE_DIR}/../doc/introspect.xsl
118
install(FILES ${EXTRA_DIST} DESTINATION share/doc/dbus)
120
endif(DBUS_ENABLE_XML_DOCS)