doc/CMakeLists.txt

IF(BUILD_DOC)

CONFIGURE_FILE(
  ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in
  ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
)

SET(examples_targets "")
SET(snippets_targets "")

ADD_SUBDIRECTORY(examples)
ADD_SUBDIRECTORY(snippets)

ADD_CUSTOM_TARGET(
  run_doxygen
  ALL
  COMMAND doxygen
  WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
)

ADD_DEPENDENCIES(run_doxygen all_snippets all_examples)

ENDIF(BUILD_DOC)
now cmake takes snippets of code, completes them into compilable sources, builds them, executes them and stores their output in files. 2007-12-21 09:30:32 +00:00			`IF(BUILD_DOC)`

first version of CMakeLists auto-generating examples outputs 2007-12-21 09:02:24 +00:00			`CONFIGURE_FILE(`
			`${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in`
			`${CMAKE_CURRENT_BINARY_DIR}/Doxyfile`
			`)`
add example to the documentation 2007-09-28 06:17:36 +00:00
everything works, make now runs doxygen once and only once, after all the required files have been generated. 2007-12-21 11:29:04 +00:00			`SET(examples_targets "")`
			`SET(snippets_targets "")`

now we also have a examples/ directory for self-contained examples, and this is already used to document DynBlock 2007-12-21 10:35:00 +00:00			`ADD_SUBDIRECTORY(examples)`
now cmake takes snippets of code, completes them into compilable sources, builds them, executes them and stores their output in files. 2007-12-21 09:30:32 +00:00			`ADD_SUBDIRECTORY(snippets)`

everything works, make now runs doxygen once and only once, after all the required files have been generated. 2007-12-21 11:29:04 +00:00			`ADD_CUSTOM_TARGET(`
			`run_doxygen`
			`ALL`
			`COMMAND doxygen`
			`WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}`
			`)`

			`ADD_DEPENDENCIES(run_doxygen all_snippets all_examples)`

now cmake takes snippets of code, completes them into compilable sources, builds them, executes them and stores their output in files. 2007-12-21 09:30:32 +00:00			`ENDIF(BUILD_DOC)`