Merge "Added travis.yml for auto-building patches" into devel/master
[platform/core/uifw/dali-core.git] / dali / public-api / signals / callback.h
index ed70539..bdba502 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,47 @@ 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 );
+  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 +363,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 +373,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 +385,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 +406,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 +435,7 @@ struct Destroyer
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T >
 struct Dispatcher0
@@ -405,6 +443,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 +458,7 @@ struct Dispatcher0
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1 >
 struct Dispatcher1
@@ -426,6 +466,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 +482,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 +490,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 +507,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 +515,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 +533,7 @@ struct Dispatcher3
 
 /**
  * @brief Dispatcher to call the actual member function.
+ * @SINCE_1_0.0
  */
 template< class T, typename R >
 struct DispatcherReturn0
@@ -495,6 +541,7 @@ struct DispatcherReturn0
   /**
    * @brief Call an actual member function.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @return the value.
    */
@@ -510,6 +557,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 +565,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 +582,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 +590,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 +608,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 +616,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 +635,7 @@ struct DispatcherReturn3
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T >
 struct FunctorDispatcher0
@@ -589,6 +643,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 +656,7 @@ struct FunctorDispatcher0
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1 >
 struct FunctorDispatcher1
@@ -608,6 +664,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 +678,7 @@ struct FunctorDispatcher1
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename P1, typename P2 >
 struct FunctorDispatcher2
@@ -628,6 +686,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 +701,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 +709,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 +725,7 @@ struct FunctorDispatcher3
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename R >
 struct FunctorDispatcherReturn0
@@ -671,6 +733,7 @@ struct FunctorDispatcherReturn0
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @return the value.
    */
@@ -684,6 +747,7 @@ struct FunctorDispatcherReturn0
 
 /**
  * @brief Dispatcher to call a functor.
+ * @SINCE_1_0.0
  */
 template< class T, typename R, typename P1 >
 struct FunctorDispatcherReturn1
@@ -691,6 +755,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 +770,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 +778,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 +794,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 +802,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 +819,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 +829,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 +846,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 +854,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 +872,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 +880,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 +899,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 +907,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 +927,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 +935,7 @@ struct VoidFunctorDispatcherReturn0
   /**
    * @brief Call a function object.
    *
+   * @SINCE_1_0.0
    * @param[in] callback The callback information.
    * @return the value.
    */
@@ -874,6 +954,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 +962,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 +982,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 +990,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 +1011,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 +1019,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 +1041,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 +1051,7 @@ public:
   /**
    * @brief Default constructor.
    *
+   * @SINCE_1_0.0
    */
   Callback()
   : CallbackBase()
@@ -974,6 +1062,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 +1110,7 @@ public:
 
 /**
  * @brief Specializations for static function callbacks.
+ * @SINCE_1_0.0
  */
 class CallbackFunction : public CallbackBase
 {
@@ -1028,6 +1118,7 @@ public:
 
   /**
    * @brief Default constructor.
+   * @SINCE_1_0.0
    */
   CallbackFunction()
   : CallbackBase()
@@ -1037,6 +1128,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 +1167,7 @@ public:
 
 /**
  * @brief Specializations for function object callbacks.
+ * @SINCE_1_0.0
  */
 template< class T >
 class CallbackFunctor0 : public CallbackBase
@@ -1084,6 +1177,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 +1189,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 class CallbackFunctorDelegate0 : public CallbackBase
 {
@@ -1104,6 +1199,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 +1211,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 +1221,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 +1233,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods.
+ * @SINCE_1_0.0
  */
 template< typename P1 >
 class CallbackFunctorDelegate1 : public CallbackBase
@@ -1145,6 +1244,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 +1256,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 +1266,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 +1278,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 +1289,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 +1301,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 +1311,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 +1323,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 +1335,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 +1347,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 +1357,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 +1369,7 @@ public:
 
 /**
  * @brief Function object callback for connecting void() methods
+ * @SINCE_1_0.0
  */
 template< typename R >
 class CallbackFunctorDelegateReturn0 : public CallbackBase
@@ -1269,6 +1380,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 +1392,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 +1402,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 +1414,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 +1425,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 +1437,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 +1447,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 +1459,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 +1470,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 +1482,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 +1492,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 +1504,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 +1515,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 +1530,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 +1542,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 +1555,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 +1568,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 +1581,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 +1594,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 +1607,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 +1620,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 +1634,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 +1649,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 +1664,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 +1679,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 +1694,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 +1709,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 +1724,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 +1739,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 +1754,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 +1768,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 +1779,9 @@ inline CallbackBase* MakeCallback( T& object, void(Base::*function)(void) )
   return new Callback< T >( object, function );
 }
 
+/**
+ * @}
+ */
 } // namespace DALI
 
 #endif // __DALI_CALLBACK_H__