now we also have a examples/ directory for self-contained examples,

and this is already used to document DynBlock

doc/CMakeLists.txt

@@ -5,6 +5,7 @@ CONFIGURE_FILE(
   ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
 )
 
+ADD_SUBDIRECTORY(examples)
 ADD_SUBDIRECTORY(snippets)
 
 ENDIF(BUILD_DOC)

doc/Doxyfile.in

@@ -85,7 +85,7 @@ WARN_LOGFILE           =
 #---------------------------------------------------------------------------
 # configuration options related to the input files
 #---------------------------------------------------------------------------
-INPUT                  = ${CMAKE_SOURCE_DIR}
+INPUT                  = ${CMAKE_SOURCE_DIR}/doc ${CMAKE_SOURCE_DIR}/Eigen
 INPUT_ENCODING         = UTF-8
 FILE_PATTERNS          = *.c \
                          *.cc \
@@ -133,7 +133,9 @@ EXCLUDE                =
 EXCLUDE_SYMLINKS       = NO
 EXCLUDE_PATTERNS       = 
 EXCLUDE_SYMBOLS        = 
-EXAMPLE_PATH           = ${CMAKE_SOURCE_DIR}/doc/examples \
+EXAMPLE_PATH           = ${CMAKE_SOURCE_DIR}/doc/snippets \
+                         ${CMAKE_BINARY_DIR}/doc/snippets \
+                         ${CMAKE_SOURCE_DIR}/doc/examples \
                          ${CMAKE_BINARY_DIR}/doc/examples
 EXAMPLE_PATTERNS       = *
 EXAMPLE_RECURSIVE      = NO

doc/examples/CMakeLists.txt

@@ -0,0 +1,14 @@
+FILE(GLOB examples_SRCS "*.cpp")
+
+FOREACH(example_src ${examples_SRCS})
+GET_FILENAME_COMPONENT(example ${example_src} NAME_WE)
+ADD_EXECUTABLE(${example} ${example_src})
+GET_TARGET_PROPERTY(example_executable
+                    ${example} LOCATION)
+ADD_CUSTOM_COMMAND(
+  TARGET ${example}
+  POST_BUILD
+  COMMAND ${example_executable}
+  ARGS >${CMAKE_CURRENT_BINARY_DIR}/${example}.out
+)
+ENDFOREACH(example_src)

doc/examples/class_DynBlock.cpp

@@ -0,0 +1,19 @@
+#include <Eigen/Core.h>
+USING_EIGEN_DATA_TYPES
+using namespace std;
+
+template<typename Scalar, typename Derived>
+Eigen::DynBlock<Derived>
+topLeftCorner(const Eigen::MatrixBase<Scalar, Derived>& m, int rows, int cols)
+{
+  return m.dynBlock(0, 0, rows, cols);
+}
+
+int main(int, char**)
+{
+  Matrix4d m = Matrix4d::identity();
+  cout << topLeftCorner(m, 2, 3) << endl;
+  topLeftCorner(m, 2, 3) *= 5;
+  cout << "Now the matrix m is:" << endl << m << endl;
+  return 0;
+}

doc/snippets/compile_snippet.cpp.in

@@ -4,4 +4,5 @@ using namespace std;
 int main(int, char**)
 {
 ${snippet_source_code}
+return 0;
 }