diff --git a/Boolean_set_operations_2/doc/Boolean_set_operations_2/CGAL/Boolean_set_operations_2.h b/Boolean_set_operations_2/doc/Boolean_set_operations_2/CGAL/Boolean_set_operations_2.h
index 66686d1dbd2..4f1ed78e348 100644
--- a/Boolean_set_operations_2/doc/Boolean_set_operations_2/CGAL/Boolean_set_operations_2.h
+++ b/Boolean_set_operations_2/doc/Boolean_set_operations_2/CGAL/Boolean_set_operations_2.h
@@ -68,10 +68,9 @@ The value type of the `OutputIterator` is either
 `Polygon_with_holes_2` or
 `General_polygon_with_holes_2`.
 
-The signature of the function is
-\code
-  OutputIterator difference(const Type1 & p1, const Type2 & p2, OutputIterator oi);
-\endcode
+The signature of the function is:
+  - `%OutputIterator %difference(const Type1 & p1, const Type2 & p2, %OutputIterator oi);`
+
 
 \cgalHeading{Parameters}
 
@@ -187,14 +186,13 @@ namespace CGAL {
 Each one of these functions computes if the interior of two given
 polygons `p1` and `p2` intersect.
 
-The signature of the function is
-\code
-  bool do_intersect(const Type1 & p1, const Type2 & p2);
-\endcode
+The signature of the function is:
+  - `bool do_intersect(const Type1 & p1, const Type2 & p2);`
+
 
 \cgalHeading{Parameters}
 
-The types of the parameters of the `do_intersect()` function are any of the following combinations.
+The types of the parameters of the \link ref_bso_do_intersect `do_intersect()` \endlink function are any of the following combinations.
 
 <div align="left">
 <table cellpadding=3 border="1">
@@ -316,10 +314,9 @@ holes into an output container through a given output iterator
 `General_polygon_with_holes_2`.
 
 
-The signature of the function is
-\code
-  OutputIterator intersection(const Type1 & p1, const Type2 & p2, OutputIterator oi);
-\endcode
+The signature of the function is:
+  - `%OutputIterator %intersection(const Type1 & p1, const Type2 & p2, %OutputIterator oi);`
+
 
 
 \cgalHeading{Parameters}
@@ -476,10 +473,9 @@ Each one of these functions computes the union of two given polygons
 returns `false`.
 
 
-The signature of the function is
-\code
-  bool join(const Type1 & p1, const Type2 & p2, General_polygon_with_holes_2 & res);
-\endcode
+The signature of the function is:
+  - `bool join(const Type1 & p1, const Type2 & p2, General_polygon_with_holes_2 & res);`
+
 
 \cgalHeading{Parameters}
 
@@ -630,10 +626,8 @@ given polygons `p1` and `p2` intersect in their interior,
 all, and `ON_ORIENTED_BOUNDARY` if `p1` and `p2` intersect
 only in their boundaries.
 
-The signature of the function is
-\code
-  Oriented_side oriented_side(const Type1 & p1, const Type2 & p2);
-\endcode
+The signature of the function is:
+  - `Oriented_side oriented_side(const Type1 & p1, const Type2 & p2);`
 
 \cgalHeading{Parameters}
 
@@ -716,10 +710,8 @@ iterator `oi`. The value type of the `OutputIterator` is either
 `Polygon_with_holes_2` or
 `General_polygon_with_holes_2`.
 
-The signature of the function is
-\code
-  OutputIterator symmetric_difference(const Type1 & p1, const Type2 & p2, OutputIterator oi);
-\endcode
+The signature of the function is:
+  - `%OutputIterator symmetric_difference(const Type1 & p1, const Type2 & p2, %OutputIterator oi);`
 
 \cgalHeading{Parameters}