diff --git a/lemon/dim2.h b/lemon/dim2.h
--- a/lemon/dim2.h
+++ b/lemon/dim2.h
@@ -533,10 +533,10 @@
     };//class Boundingbox
 
 
-  ///Map of x-coordinates of a \ref Point "Point"-map
+  ///Map of x-coordinates of a Point map
 
   ///\ingroup maps
-  ///Map of x-coordinates of a \ref Point "Point"-map.
+  ///Map of x-coordinates of a \ref dim2::Point "Point"-map.
   ///
   template<class M>
   class XMap 
@@ -570,7 +570,7 @@
     return XMap<M>(m);
   }
 
-  ///Constant (read only) version of \ref XMap
+  ///Constant (read only) version of XMap
 
   ///\ingroup maps
   ///Constant (read only) version of \ref XMap
@@ -600,7 +600,7 @@
     return ConstXMap<M>(m);
   }
 
-  ///Map of y-coordinates of a \ref Point "Point"-map
+  ///Map of y-coordinates of a Point map
     
   ///\ingroup maps
   ///Map of y-coordinates of a \ref Point "Point"-map.
@@ -637,7 +637,7 @@
     return YMap<M>(m);
   }
 
-  ///Constant (read only) version of \ref YMap
+  ///Constant (read only) version of YMap
 
   ///\ingroup maps
   ///Constant (read only) version of \ref YMap
@@ -668,8 +668,8 @@
   }
 
 
-    ///\brief Map of the \ref Point::normSquare() "normSquare()"
-    ///of a \ref Point "Point"-map
+    ///\brief Map of the normSquare()
+    ///of a Point map
     ///
     ///Map of the \ref Point::normSquare() "normSquare()"
     ///of a \ref Point "Point"-map.
diff --git a/lemon/maps.h b/lemon/maps.h
--- a/lemon/maps.h
+++ b/lemon/maps.h
@@ -174,13 +174,13 @@
   public:
 
     typedef True ReferenceMapTag;
-    ///\e
+    ///Key type
     typedef K Key;
-    ///\e
+    ///Value type
     typedef T Value;
-    ///\e
+    ///Reference Type
     typedef T& Reference;
-    ///\e
+    ///Const reference type
     typedef const T& ConstReference;
 
   private:
diff --git a/lemon/tolerance.h b/lemon/tolerance.h
--- a/lemon/tolerance.h
+++ b/lemon/tolerance.h
@@ -41,7 +41,7 @@
   ///as a result of a probably inexact computation.
   ///
   ///This is an abstract class, it should be specialized for all numerical
-  ///data types. These specialized classes like \ref Tolerance\<double\>
+  ///data types. These specialized classes like Tolerance<double>
   ///may offer additional tuning parameters.
   ///
   ///\sa Tolerance<float>
@@ -91,9 +91,9 @@
   };
 
 
-  ///Float specialization of \ref Tolerance.
+  ///Float specialization of Tolerance.
 
-  ///Float specialization of \ref Tolerance.
+  ///Float specialization of Tolerance.
   ///\sa Tolerance
   ///\relates Tolerance
   template<>
@@ -142,9 +142,9 @@
     static Value zero() {return 0;}
   };
 
-  ///Double specialization of \ref Tolerance.
+  ///Double specialization of Tolerance.
 
-  ///Double specialization of \ref Tolerance.
+  ///Double specialization of Tolerance.
   ///\sa Tolerance
   ///\relates Tolerance
   template<>
@@ -193,9 +193,9 @@
     static Value zero() {return 0;}
   };
 
-  ///Long double specialization of \ref Tolerance.
+  ///Long double specialization of Tolerance.
 
-  ///Long double specialization of \ref Tolerance.
+  ///Long double specialization of Tolerance.
   ///\sa Tolerance
   ///\relates Tolerance
   template<>
@@ -244,9 +244,9 @@
     static Value zero() {return 0;}
   };
 
-  ///Integer specialization of \ref Tolerance.
+  ///Integer specialization of Tolerance.
 
-  ///Integer specialization of \ref Tolerance.
+  ///Integer specialization of Tolerance.
   ///\sa Tolerance
   template<>
   class Tolerance<int>
@@ -256,7 +256,7 @@
     typedef int Value;
 
     ///\name Comparisons
-    ///See \ref Tolerance for more details.
+    ///See Tolerance for more details.
 
     ///@{
 
@@ -277,7 +277,7 @@
     static Value zero() {return 0;}
   };
 
-  ///Unsigned integer specialization of \ref Tolerance.
+  ///Unsigned integer specialization of Tolerance.
 
   ///Unsigned integer specialization of \ref Tolerance.
   ///\sa Tolerance
@@ -289,7 +289,7 @@
     typedef unsigned int Value;
 
     ///\name Comparisons
-    ///See \ref Tolerance for more details.
+    ///See Tolerance for more details.
 
     ///@{
 
@@ -311,9 +311,9 @@
   };
   
 
-  ///Long integer specialization of \ref Tolerance.
+  ///Long integer specialization of Tolerance.
 
-  ///Long integer specialization of \ref Tolerance.
+  ///Long integer specialization of Tolerance.
   ///\sa Tolerance
   template<>
   class Tolerance<long int>
@@ -323,7 +323,7 @@
     typedef long int Value;
 
     ///\name Comparisons
-    ///See \ref Tolerance for more details.
+    ///See Tolerance for more details.
 
     ///@{
 
@@ -344,7 +344,7 @@
     static Value zero() {return 0;}
   };
 
-  ///Unsigned long integer specialization of \ref Tolerance.
+  ///Unsigned long integer specialization of Tolerance.
 
   ///Unsigned long integer specialization of \ref Tolerance.
   ///\sa Tolerance
@@ -356,7 +356,7 @@
     typedef unsigned long int Value;
 
     ///\name Comparisons
-    ///See \ref Tolerance for more details.
+    ///See Tolerance for more details.
 
     ///@{
 
@@ -379,7 +379,7 @@
 
 #if defined __GNUC__ && !defined __STRICT_ANSI__
 
-  ///Long long integer specialization of \ref Tolerance.
+  ///Long long integer specialization of Tolerance.
 
   ///Long long integer specialization of \ref Tolerance.
   ///\warning This class (more exactly, type <tt>long long</tt>)
@@ -414,7 +414,7 @@
     static Value zero() {return 0;}
   };
 
-  ///Unsigned long long integer specialization of \ref Tolerance.
+  ///Unsigned long long integer specialization of Tolerance.
 
   ///Unsigned long long integer specialization of \ref Tolerance.
   ///\warning This class (more exactly, type <tt>unsigned long long</tt>)