Using CMake to run Doxygen

.gitignore

@@ -1,4 +1,3 @@
 build
-doc/*
 *.pro.user
 CMakeLists.txt.user

CMakeLists.txt

@@ -4,6 +4,10 @@ cmake_minimum_required(VERSION 2.8)
 find_package(Qt4 4.6 REQUIRED QtCore QtNetwork)
 
 # Configure options
+option(GENERATE_DOC
+    "Use Doxygen to generate the project documentation" OFF
+)
+
 set(BUFFER_SIZE 128 CACHE STRING
     "The default buffer size (in bytes) used by Tufão")
 add_definitions(-DBUFFER_SIZE=${BUFFER_SIZE})
@@ -21,6 +25,10 @@ add_subdirectory(src)
 add_subdirectory(include)
 add_subdirectory(pkg)
 
+if (GENERATE_DOC)
+    add_subdirectory(doc)
+endif()
+
 # uninstall target
 configure_file(
     "${CMAKE_CURRENT_SOURCE_DIR}/cmake_uninstall.cmake.in"

README

@@ -57,6 +57,7 @@ OPTIONS can be null or have a combination of the following values:
   * -DCMAKE_BUILD_TYPE=Release
   * -DCMAKE_BUILD_TYPE=RelWithDebInfo
   * -DCMAKE_BUILD_TYPE=MinSizeRel
+  * -DGENERATE_DOC=YES generate documentation using Doxygen
 
 OPTIONS available on Windows:
   * -G"MinGW Makefiles" to generate Makefiles for use with MinGW environment

doc/CMakeLists.txt

@@ -0,0 +1,33 @@
+find_package(Doxygen REQUIRED)
+
+# Configure info
+configure_file(${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in
+    ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
+    @ONLY
+)
+
+# Build info
+add_custom_target(doc ALL
+    "${DOXYGEN_EXECUTABLE}" "${CMAKE_CURRENT_BINARY_DIR}/Doxyfile"
+    WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
+    COMMENT "Generating API documentation with Doxygen"
+)
+add_custom_target(pdfdoc ALL
+    make
+    WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/latex"
+    COMMENT "Running make to generate PDF output"
+    DEPENDS doc
+)
+
+# Install info
+#  html an qch
+install(DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/html" "${CMAKE_CURRENT_BINARY_DIR}/qch"
+    DESTINATION "share/doc/tufao"
+    COMPONENT doc
+    PATTERN index.qhp EXCLUDE
+)
+#  pdf
+install(FILES "${CMAKE_CURRENT_BINARY_DIR}/latex/refman.pdf"
+    DESTINATION "share/doc/tufao/pdf"
+    COMPONENT doc
+)