everything works, make now runs doxygen once and only once, after all

the required files have been generated.

Eigen/Core/DynBlock.h

@@ -42,6 +42,8 @@
   * \include class_DynBlock.cpp
   * Output:
   * \verbinclude class_DynBlock.out
+  *
+  * \sa MatrixBase::dynBlock()
   */
 template<typename MatrixType> class DynBlock
   : public MatrixBase<typename MatrixType::Scalar, DynBlock<MatrixType> >

Mainpage.dox

@@ -11,6 +11,6 @@ In order to generate the documentation for Eigen, follow these steps:
   <li>now generate the documentaion: <pre>make</pre> or, if you have two CPUs, <pre>make -j2</pre> Note that this will compile the examples, run them, and integrate their output into the documentation. This is why it can take some time.</li>
 </ul>
 
-You will now find in the build directory a 'html' subdirectory containing the HTML documentation for Eigen.
+You will now find the HTML documentation in the doc/html/ subdirectory of the build directory.
 
 */

doc/CMakeLists.txt

@@ -5,7 +5,19 @@ CONFIGURE_FILE(
   ${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)

doc/Doxyfile.in

@@ -6,7 +6,7 @@
 DOXYFILE_ENCODING      = UTF-8
 PROJECT_NAME           = Eigen
 PROJECT_NUMBER         = 2.0-alpha1
-OUTPUT_DIRECTORY       = ${CMAKE_BINARY_DIR}
+OUTPUT_DIRECTORY       = ${CMAKE_BINARY_DIR}/doc
 CREATE_SUBDIRS         = NO
 OUTPUT_LANGUAGE        = English
 BRIEF_MEMBER_DESC      = YES
@@ -259,7 +259,7 @@ MSCGEN_PATH            =
 HIDE_UNDOC_RELATIONS   = YES
 HAVE_DOT               = YES
 CLASS_GRAPH            = YES
-COLLABORATION_GRAPH    = YES
+COLLABORATION_GRAPH    = NO
 GROUP_GRAPHS           = YES
 UML_LOOK               = NO
 TEMPLATE_RELATIONS     = NO

doc/examples/CMakeLists.txt

@@ -1,5 +1,7 @@
 FILE(GLOB examples_SRCS "*.cpp")
 
+ADD_CUSTOM_TARGET(all_examples)
+
 FOREACH(example_src ${examples_SRCS})
 GET_FILENAME_COMPONENT(example ${example_src} NAME_WE)
 ADD_EXECUTABLE(${example} ${example_src})
@@ -11,4 +13,5 @@ ADD_CUSTOM_COMMAND(
   COMMAND ${example_executable}
   ARGS >${CMAKE_CURRENT_BINARY_DIR}/${example}.out
 )
+ADD_DEPENDENCIES(all_examples ${example})
 ENDFOREACH(example_src)

doc/snippets/CMakeLists.txt

@@ -1,5 +1,7 @@
 FILE(GLOB snippets_SRCS "*.cpp")
 
+ADD_CUSTOM_TARGET(all_snippets)
+
 FOREACH(snippet_src ${snippets_SRCS})
 GET_FILENAME_COMPONENT(snippet ${snippet_src} NAME_WE)
 SET(compile_snippet_target compile_${snippet})
@@ -17,4 +19,5 @@ ADD_CUSTOM_COMMAND(
   COMMAND ${compile_snippet_executable}
   ARGS >${CMAKE_CURRENT_BINARY_DIR}/${snippet}.out
 )
+ADD_DEPENDENCIES(all_snippets ${compile_snippet_target})
 ENDFOREACH(snippet_src)