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

and this is already used to document DynBlock

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;
+}