diff -r 8d76a7bf9961 -r 0310c8984732 lemon/dfs.h
--- a/lemon/dfs.h	Mon Sep 01 22:00:40 2008 +0200
+++ b/lemon/dfs.h	Tue Sep 09 20:52:45 2008 +0100
@@ -1208,6 +1208,11 @@
   /// class. It works with callback mechanism, the DfsVisit object calls
   /// the member functions of the \c Visitor class on every DFS event.
   ///
+  /// This interface of the DFS algorithm should be used in special cases
+  /// when extra actions have to be performed in connection with certain
+  /// events of the DFS algorithm. Otherwise consider to use Dfs or dfs()
+  /// instead.
+  ///
   /// \tparam _Digraph The type of the digraph the algorithm runs on.
   /// The default value is
   /// \ref ListDigraph. The value of _Digraph is not used directly by