/** 
     @param event event the function will be called at
     @param func functor (see boost function) that will be called
+    @note use boost::bind to bind to member functions and parameters like this:
+    @verbatim
+        // in this example 17 is a fixed parameter that is always added to the call
+        c.add_callback(connection_closed,bind(&my_class::func_to_call_back, boost::ref(*this), 17));
+    @endverbatim
 */
 void client_connection::add_callback(callback_event_type event, const boost::function<void ()>& func)
 {
     callbacks[event].push_back(func);
 }
 
-/**
-    @example callback use boost::bind to bind to member functions and parameters like this:
-        int this example 17 is a fixed parameter that is always added to the call
-        c.add_callback(connection_closed,bind(&my_class::func_to_call_back, boost::ref(*this), 17));
-*/
 
 
 void client_connection::do_callbacks(callback_event_type event)
 
     @param event event the function will be called at
     @param func functor (see boost function) that will be called
 
-    @example use boost::bind to bind to member functions and parameters like this:
+    @note use boost::bind to bind to member functions and parameters like this:
         17 is a fixed parameter that is always added to the call
         c.add_callback(connection_closed,bind(&my_class::func_to_call_back, boost::ref(*this), 17));
 */
     @param event event the function will be called at
     @param func functor (see boost function) that will be called
 
-    @example use boost::bind to bind to member functions like this:
+    @note use boost::bind to bind to member functions like this:
         s.add_callback(new_connection,bind(&my_class::func_to_call_back, boost::ref(*this), _1));
 */
 void server::add_callback(callback_event_type event, const boost::function<void (unsigned int)>& func)