Added CMake target for documentation.

CMakeLists.txt

@@ -14,11 +14,12 @@ option(GLFW_BUILD_EXAMPLES "Build the GLFW example programs" ON)
 option(GLFW_BUILD_TESTS "Build the GLFW test programs" ON)
 option(BUILD_SHARED_LIBS "Build shared libraries" OFF)
 
-option(GLFW_DOCUMENT_INTERNALS "Include documentation of internal functions" OFF)
+set(DOXYGEN_SKIP_DOT TRUE)
+find_package(Doxygen)
 
-set(GLFW_DOC_HEADERS "${GLFW_SOURCE_DIR}/include/GL/glfw3.h ${GLFW_SOURCE_DIR}/include/GL/glfw3native.h")
+option(GLFW_DOCUMENT_INTERNALS "Include internals in documentation" OFF)
 if (GLFW_DOCUMENT_INTERNALS)
-    set(GLFW_DOC_HEADERS "${GLFW_DOC_HEADERS} ${GLFW_SOURCE_DIR}/src/internal.h")
+    set(GLFW_DOC_HEADERS "${GLFW_SOURCE_DIR}/src/internal.h")
 endif()
 
 if (APPLE)
@@ -355,6 +356,10 @@ if (GLFW_BUILD_TESTS)
     add_subdirectory(tests)
 endif()
 
+if (DOXYGEN_FOUND)
+    add_subdirectory(docs)
+endif()
+
 #--------------------------------------------------------------------
 # Create generated files
 #--------------------------------------------------------------------

docs/CMakeLists.txt

@@ -0,0 +1,5 @@
+
+add_custom_target(docs ${DOXYGEN_EXECUTABLE}
+                  WORKING_DIRECTORY ${GLFW_BINARY_DIR}/docs
+                  COMMENT "Generating HTML documentation" VERBATIM)
+

docs/Doxyfile.in

@@ -656,7 +656,7 @@ WARN_LOGFILE           = @GLFW_BINARY_DIR@/docs/warnings.txt
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = @GLFW_DOC_HEADERS@ @GLFW_SOURCE_DIR@/docs/
+INPUT                  = @GLFW_DOC_HEADERS@ @GLFW_SOURCE_DIR@/include/GL/ @GLFW_SOURCE_DIR@/docs/
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@@ -674,7 +674,7 @@ INPUT_ENCODING         = UTF-8
 # *.hxx *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.dox *.py
 # *.f90 *.f *.for *.vhd *.vhdl
 
-FILE_PATTERNS          = *.dox
+FILE_PATTERNS          = *.h *.dox
 
 # The RECURSIVE tag can be used to turn specify whether or not subdirectories
 # should be searched for input files as well. Possible values are YES and NO.