[3.0] Add missed doxygen documentation
[platform/core/uifw/dali-core.git] / dali / public-api / signals / callback.h
index ed70539..add533c 100644 (file)
 
 namespace Dali
 {
+/**
+ * @addtogroup dali_core_signals
+ * @{
+ */
 
 class CallbackBase;
 
 /**
  * @brief Callback base class to hold the data for callback function and member function calls.
+ * @SINCE_1_0.0
  */
 class DALI_IMPORT_API CallbackBase
 {
@@ -39,22 +44,26 @@ public:
 
   /**
    * @brief Default constructor
+   * @SINCE_1_0.0
    */
   CallbackBase();
 
   /**
    * @brief Destructor
+   * @SINCE_1_0.0
    */
   ~CallbackBase();
 
   /**
    * @brief Resets the object pointer so that we know not to call methods of this object any more.
+   * @SINCE_1_0.0
    */
   void Reset();
 
   /**
    * @brief Function to call the function or member function dispatcher
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    */
   static void Execute( CallbackBase& callback )
@@ -83,6 +92,7 @@ public:
   /**
    * @brief Function to call the function or member function dispatcher.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @return value from the function
    */
@@ -113,6 +123,7 @@ public:
    * @brief Function to call the function or member function dispatcher.
    *
    * This function template gets instantiated at the call site
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @param[in] param1 The first parameter to pass into the function.
    */
@@ -141,6 +152,7 @@ public:
    * @brief Function to call the function or member function dispatcher.
    *
    * This function template gets instantiated at the call site
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @param[in] param1 The first parameter to pass into the function.
    * @return the value from the function
@@ -173,6 +185,7 @@ public:
    * @brief Function to call the function or member function dispatcher.
    *
    * This function template gets instantiated at the call site.
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @param[in] param1 The first parameter to pass into the function.
    * @param[in] param2 The second parameter to pass into the function.
@@ -202,6 +215,7 @@ public:
    * @brief Function to call the function or member function dispatcher.
    *
    * This function template gets instantiated at the call site
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @param[in] param1 The first parameter to pass into the function.
    * @param[in] param2 The second parameter to pass into the function.
@@ -235,6 +249,7 @@ public:
    * @brief Function to call the function or member function dispatcher.
    *
    * This function template gets instantiated at the call site.
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @param[in] param1 The first parameter to pass into the function.
    * @param[in] param2 The second parameter to pass into the function.
@@ -265,6 +280,7 @@ public:
    * @brief Function to call the function or member function dispatcher.
    *
    * This function template gets instantiated at the call site
+   * @SINCE_1_0.0
    * @param[in] callback The callback to call.
    * @param[in] param1 The first parameter to pass into the function.
    * @param[in] param2 The second parameter to pass into the function.
@@ -299,36 +315,46 @@ protected: // Constructors for deriving classes
 
   /**
    * @brief Function with static linkage
+   * @SINCE_1_0.0
    */
   typedef void(*Function)(void);
 
   /**
    * @brief Member function
+   * @SINCE_1_0.0
    */
   typedef void (CallbackBase::*MemberFunction)( void );
 
   /**
    * @brief Used to call the correct member function
+   * @SINCE_1_0.0
    */
   typedef void (*Dispatcher)( CallbackBase& base );
 
   /**
    * @brief Used to destroy mObjectPointer (NULL if not mObjectPointer is not owned)
+   * @SINCE_1_0.0
    */
   typedef void(*Destructor)(void* object);
 
   /**
    * @brief Copy constructor operator not declared.
+   * @SINCE_1_0.0
+   * @param[in] rhs Handle to an object
    */
   CallbackBase( const CallbackBase& rhs );
   /**
    * @brief assignment operator not declared.
+   * @SINCE_1_0.0
+   * @param[in] rhs Handle to an object
+   * @return A reference to this
    */
   const CallbackBase& operator=( const CallbackBase& rhs );
 
   /**
    * @brief Constructor for function with static linkage.
    *
+   * @SINCE_1_0.0
    * @param[in] function The function to call.
    */
   CallbackBase( Function function );
@@ -336,6 +362,7 @@ protected: // Constructors for deriving classes
   /**
    * @brief Constructor for member function.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to call (not owned).
    * @param[in] function The member function of the object.
    * @param[in] dispatcher Used to call the actual object.
@@ -345,6 +372,7 @@ protected: // Constructors for deriving classes
   /**
    * @brief Constructor for member function.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to call (owned).
    * @param[in] function The member function of the object.
    * @param dispatcher Used to call the actual object.
@@ -356,10 +384,11 @@ public: // Data for deriving classes & Dispatchers
 
   /**
    * @brief struct to hold the extra data needed for member functions.
+   * @SINCE_1_0.0
    */
   struct Impl
   {
-    Impl();                               ///< Default constructor
+    Impl();                               ///< Default constructor @SINCE_1_0.0
 
     void* mObjectPointer;                 ///< Object whose member function will be called. Not owned if mDestructorDispatcher is NULL.
     Dispatcher mMemberFunctionDispatcher; ///< Dispatcher for member functions
@@ -376,17 +405,24 @@ public: // Data for deriving classes & Dispatchers
 
 /**
  * @brief Non-member equality operator
+ * @SINCE_1_0.0
+ * @param[in] lhs A reference to compare
+ * @param[in] rhs A reference to compare to
+ * @return true if lhs is same as rhs
  */
 bool operator==( const CallbackBase& lhs, const CallbackBase& rhs );
 
 /**
  * @brief Dispatcher to delete an object.
+ * @SINCE_1_0.0
  */
 template< class T >
 struct Destroyer
 {
   /**
    * @brief Dispatcher to delete an object.
+   * @SINCE_1_0.0
+   * @param[in] object An object to delete
    */
   static void Delete( void* object )
   {
@@ -398,6 +434,7 @@ struct Destroyer
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T >
 struct Dispatcher0
@@ -405,6 +442,7 @@ struct Dispatcher0
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    */
   static void Dispatch( CallbackBase& callback )
@@ -419,6 +457,7 @@ struct Dispatcher0
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1 >
 struct Dispatcher1
@@ -426,6 +465,7 @@ struct Dispatcher1
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    */
@@ -441,6 +481,7 @@ struct Dispatcher1
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2 >
 struct Dispatcher2
@@ -448,6 +489,7 @@ struct Dispatcher2
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -464,6 +506,7 @@ struct Dispatcher2
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2, typename P3 >
 struct Dispatcher3
@@ -471,6 +514,7 @@ struct Dispatcher3
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -488,6 +532,7 @@ struct Dispatcher3
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename R >
 struct DispatcherReturn0
@@ -495,6 +540,7 @@ struct DispatcherReturn0
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @return the value.
    */
@@ -510,6 +556,7 @@ struct DispatcherReturn0
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1 >
 struct DispatcherReturn1
@@ -517,6 +564,7 @@ struct DispatcherReturn1
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @return The return value from the function
@@ -533,6 +581,7 @@ struct DispatcherReturn1
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1, typename P2 >
 struct DispatcherReturn2
@@ -540,6 +589,7 @@ struct DispatcherReturn2
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -557,6 +607,7 @@ struct DispatcherReturn2
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1, typename P2, typename P3 >
 struct DispatcherReturn3
@@ -564,6 +615,7 @@ struct DispatcherReturn3
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -582,6 +634,7 @@ struct DispatcherReturn3
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T >
 struct FunctorDispatcher0
@@ -589,6 +642,7 @@ struct FunctorDispatcher0
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    */
   static void Dispatch( CallbackBase& callback )
@@ -601,6 +655,7 @@ struct FunctorDispatcher0
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1 >
 struct FunctorDispatcher1
@@ -608,6 +663,7 @@ struct FunctorDispatcher1
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    */
@@ -621,6 +677,7 @@ struct FunctorDispatcher1
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2 >
 struct FunctorDispatcher2
@@ -628,6 +685,7 @@ struct FunctorDispatcher2
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -642,6 +700,7 @@ struct FunctorDispatcher2
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2, typename P3 >
 struct FunctorDispatcher3
@@ -649,6 +708,7 @@ struct FunctorDispatcher3
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -664,6 +724,7 @@ struct FunctorDispatcher3
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename R >
 struct FunctorDispatcherReturn0
@@ -671,6 +732,7 @@ struct FunctorDispatcherReturn0
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @return the value.
    */
@@ -684,6 +746,7 @@ struct FunctorDispatcherReturn0
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1 >
 struct FunctorDispatcherReturn1
@@ -691,6 +754,7 @@ struct FunctorDispatcherReturn1
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @return The return value from the function
@@ -705,6 +769,7 @@ struct FunctorDispatcherReturn1
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1, typename P2 >
 struct FunctorDispatcherReturn2
@@ -712,6 +777,7 @@ struct FunctorDispatcherReturn2
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -727,6 +793,7 @@ struct FunctorDispatcherReturn2
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1, typename P2, typename P3 >
 struct FunctorDispatcherReturn3
@@ -734,6 +801,7 @@ struct FunctorDispatcherReturn3
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -750,7 +818,9 @@ struct FunctorDispatcherReturn3
 
 /**
  * @brief Dispatcher to call a functor.
+ *
  * This variant calls a specific void() member function.
+ * @SINCE_1_0.0
  */
 template< class T >
 struct VoidFunctorDispatcher0
@@ -758,6 +828,7 @@ struct VoidFunctorDispatcher0
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    */
   static void Dispatch( CallbackBase& callback )
@@ -774,6 +845,7 @@ struct VoidFunctorDispatcher0
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, ignoring any signal parameters
+ * @SINCE_1_0.0
  */
 template< class T, typename P1 >
 struct VoidFunctorDispatcher1
@@ -781,6 +853,7 @@ struct VoidFunctorDispatcher1
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    */
@@ -798,6 +871,7 @@ struct VoidFunctorDispatcher1
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, ignoring any signal parameters
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2 >
 struct VoidFunctorDispatcher2
@@ -805,6 +879,7 @@ struct VoidFunctorDispatcher2
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -823,6 +898,7 @@ struct VoidFunctorDispatcher2
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, ignoring any signal parameters
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2, typename P3 >
 struct VoidFunctorDispatcher3
@@ -830,6 +906,7 @@ struct VoidFunctorDispatcher3
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -849,6 +926,7 @@ struct VoidFunctorDispatcher3
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, and returns a default-constructed value
+ * @SINCE_1_0.0
  */
 template< class T, typename R >
 struct VoidFunctorDispatcherReturn0
@@ -856,6 +934,7 @@ struct VoidFunctorDispatcherReturn0
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @return the value.
    */
@@ -874,6 +953,7 @@ struct VoidFunctorDispatcherReturn0
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, and returns a default-constructed value
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1 >
 struct VoidFunctorDispatcherReturn1
@@ -881,6 +961,7 @@ struct VoidFunctorDispatcherReturn1
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @return The return value from the function
@@ -900,6 +981,7 @@ struct VoidFunctorDispatcherReturn1
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, and returns a default-constructed value
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1, typename P2 >
 struct VoidFunctorDispatcherReturn2
@@ -907,6 +989,7 @@ struct VoidFunctorDispatcherReturn2
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -927,6 +1010,7 @@ struct VoidFunctorDispatcherReturn2
  * @brief Dispatcher to call a functor.
  *
  * This variant calls a void() member, and returns a default-constructed value
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1, typename P2, typename P3 >
 struct VoidFunctorDispatcherReturn3
@@ -934,6 +1018,7 @@ struct VoidFunctorDispatcherReturn3
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @param[in] param1 The first parameter to pass to the real member function.
    * @param[in] param2 The second parameter to pass to the real member function.
@@ -955,6 +1040,7 @@ struct VoidFunctorDispatcherReturn3
  * @brief Thin template to provide type safety for member function callbacks.
  *
  * version with two parameters and return value
+ * @SINCE_1_0.0
  */
 template< class T >
 class Callback : public CallbackBase
@@ -964,6 +1050,7 @@ public:
   /**
    * @brief Default constructor.
    *
+   * @SINCE_1_0.0
    */
   Callback()
   : CallbackBase()
@@ -974,6 +1061,7 @@ public:
    * @brief Constructor for member function.
    *
    * Copies the function object.
+   * @SINCE_1_0.0
    * @param[in] object The object to call.
    * @param[in] memberFunction The member function of the object.
    */
@@ -1021,6 +1109,7 @@ public:
 
 /**
  * @brief Specializations for static function callbacks.
+ * @SINCE_1_0.0
  */
 class CallbackFunction : public CallbackBase
 {
@@ -1028,6 +1117,7 @@ public:
 
   /**
    * @brief Default constructor.
+   * @SINCE_1_0.0
    */
   CallbackFunction()
   : CallbackBase()
@@ -1037,6 +1127,7 @@ public:
   /**
    * @brief Constructors for functions with static linkage.
    *
+   * @SINCE_1_0.0
    * @param[in] function The function to call.
    */
   CallbackFunction( void(*function)() )
@@ -1075,6 +1166,7 @@ public:
 
 /**
  * @brief Specializations for function object callbacks.
+ * @SINCE_1_0.0
  */
 template< class T >
 class CallbackFunctor0 : public CallbackBase
@@ -1084,6 +1176,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctor0( const T& object )
@@ -1095,6 +1188,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 class CallbackFunctorDelegate0 : public CallbackBase
 {
@@ -1104,6 +1198,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object A newly allocated object (ownership is transferred).
    */
   CallbackFunctorDelegate0( FunctorDelegate* object )
@@ -1115,6 +1210,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1 >
 class CallbackFunctor1 : public CallbackBase
@@ -1124,6 +1220,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctor1( const T& object )
@@ -1135,6 +1232,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods.
+ * @SINCE_1_0.0
  */
 template< typename P1 >
 class CallbackFunctorDelegate1 : public CallbackBase
@@ -1145,6 +1243,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegate1( FunctorDelegate* object )
@@ -1156,6 +1255,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2 >
 class CallbackFunctor2 : public CallbackBase
@@ -1165,6 +1265,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctor2( const T& object )
@@ -1176,6 +1277,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename P1, typename P2 >
 class CallbackFunctorDelegate2 : public CallbackBase
@@ -1186,6 +1288,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegate2( FunctorDelegate* object )
@@ -1197,6 +1300,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2, typename P3 >
 class CallbackFunctor3 : public CallbackBase
@@ -1206,6 +1310,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctor3( const T& object )
@@ -1217,6 +1322,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename P1, typename P2, typename P3 >
 class CallbackFunctorDelegate3 : public CallbackBase
@@ -1228,6 +1334,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegate3( FunctorDelegate* object )
@@ -1239,6 +1346,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature
+ * @SINCE_1_0.0
  */
 template< class T, typename R >
 class CallbackFunctorReturn0 : public CallbackBase
@@ -1248,6 +1356,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorReturn0( const T& object )
@@ -1259,6 +1368,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename R >
 class CallbackFunctorDelegateReturn0 : public CallbackBase
@@ -1269,6 +1379,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegateReturn0( FunctorDelegate* object )
@@ -1280,6 +1391,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename R >
 class CallbackFunctorReturn1 : public CallbackBase
@@ -1289,6 +1401,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorReturn1( const T& object )
@@ -1300,6 +1413,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename P1, typename R >
 class CallbackFunctorDelegateReturn1 : public CallbackBase
@@ -1310,6 +1424,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegateReturn1( FunctorDelegate* object )
@@ -1321,6 +1436,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2, typename R >
 class CallbackFunctorReturn2 : public CallbackBase
@@ -1330,6 +1446,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorReturn2( const T& object )
@@ -1341,6 +1458,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename P1, typename P2, typename R >
 class CallbackFunctorDelegateReturn2 : public CallbackBase
@@ -1351,6 +1469,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegateReturn2( FunctorDelegate* object )
@@ -1362,6 +1481,7 @@ public:
 
 /**
  * @brief Function object callback for matching callbacks to signal signature
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2, typename P3, typename R >
 class CallbackFunctorReturn3 : public CallbackBase
@@ -1371,6 +1491,7 @@ public:
   /**
    * @brief Constructor which copies a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorReturn3( const T& object )
@@ -1382,6 +1503,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename P1, typename P2, typename P3, typename R >
 class CallbackFunctorDelegateReturn3 : public CallbackBase
@@ -1392,6 +1514,7 @@ public:
    * @brief Constructor which copies a function object.
    *
    * This variant calls a void() member, ignoring any signal parameters.
+   * @SINCE_1_0.0
    * @param[in] object The object to copy.
    */
   CallbackFunctorDelegateReturn3( FunctorDelegate* object )
@@ -1406,6 +1529,7 @@ public:
 /**
  * @brief Creates a callback from a C function or static member function with no parameters.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1417,6 +1541,7 @@ inline CallbackBase* MakeCallback( void(*function)(void) )
 /**
  * @brief Creates a callback from a C function or static member function with one parameter.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1429,6 +1554,7 @@ inline CallbackBase* MakeCallback( void(*function)(P1) )
 /**
  * @brief Creates a callback from a C function or static member function with no parameters and a return type.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1441,6 +1567,7 @@ inline CallbackBase* MakeCallback( R(*function)(void) )
 /**
  * @brief Creates a callback from a C function or static member function with one parameter and a return type.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1453,6 +1580,7 @@ inline CallbackBase* MakeCallback( R(*function)(P1) )
 /**
  * @brief Creates a callback from a C function or static member function with two parameters.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1465,6 +1593,7 @@ inline CallbackBase* MakeCallback( void(*function)(P1,P2) )
 /**
  * @brief Creates a callback from a C function or static member function with two parameters and a return type.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1477,6 +1606,7 @@ inline CallbackBase* MakeCallback( R(*function)(P1,P2) )
 /**
  * @brief Creates a callback from a C function or static member function with three parameters.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1489,6 +1619,7 @@ inline CallbackBase* MakeCallback( void(*function)(P1,P2,P3) )
 /**
  * @brief Creates a callback from a C function or static member function with three parameters and a return type.
  *
+ * @SINCE_1_0.0
  * @param[in] function The function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
  */
@@ -1502,6 +1633,7 @@ inline CallbackBase* MakeCallback( R(*function)(P1,P2,P3) )
  * @brief Creates a callback from a class member function with no parameters.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1516,6 +1648,7 @@ inline CallbackBase* MakeCallback( T* object, void(T::*function)(void) )
  * @brief Creates a callback from a class member function with one parameter.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1530,6 +1663,7 @@ inline CallbackBase* MakeCallback( T* object, void(T::*function)(P1) )
  * @brief Creates a callback from a class member function with two parameters.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1544,6 +1678,7 @@ inline CallbackBase* MakeCallback( T* object, void(T::*function)(P1,P2) )
  * @brief Creates a callback from a class member function with three parameters.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1558,6 +1693,7 @@ inline CallbackBase* MakeCallback( T* object, void(T::*function)(P1,P2,P3) )
  * @brief Creates a callback from a class member function with no parameters and a return type.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1572,6 +1708,7 @@ inline CallbackBase* MakeCallback( T* object, R(T::*function)() )
  * @brief Creates a callback from a class member function with one parameter and a return type.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1586,6 +1723,7 @@ inline CallbackBase* MakeCallback( T* object, R(T::*function)(P1) )
  * @brief Creates a callback from a class member function with two parameters and a return type.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1600,6 +1738,7 @@ inline CallbackBase* MakeCallback( T* object, R(T::*function)(P1,P2) )
  * @brief Creates a callback from a class member function with three parameters and a return type.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1614,6 +1753,7 @@ inline CallbackBase* MakeCallback( T* object, R(T::*function)(P1,P2,P3) )
  * @brief Creates a callback from a class's parent member function with no parameters.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1627,6 +1767,7 @@ inline CallbackBase* MakeCallback( T* object, void(Base::*function)(void) )
  * @brief Creates a callback from a class's parent member function with no parameters.
  *
  * requires the function to be member of the same class
+ * @SINCE_1_0.0
  * @param[in] object The object to call.
  * @param[in] function The member function to call.
  * @return a newly allocated Callback object, ownership transferred to caller
@@ -1637,6 +1778,9 @@ inline CallbackBase* MakeCallback( T& object, void(Base::*function)(void) )
   return new Callback< T >( object, function );
 }
 
+/**
+ * @}
+ */
 } // namespace DALI
 
 #endif // __DALI_CALLBACK_H__