[cluttermm] Behaviour*: Deprecate all these classes.

[Murray Cumming <murrayc src gnome org>]

commit 6fda5d3a11cbea6645a5e4d3277c9631805c912d
Author: Murray Cumming <murrayc murrayc com>
Date:   Sat Mar 22 17:59:15 2014 +0100

    Behaviour*: Deprecate all these classes.
    
    * clutter/src/behaviour*.[hg|ccg]: Use _IS_DEPRECATED to put
      them in ifdefs. Docuement them as deprecated. And disable
      clutter deprecation warnings for their implementations.

 clutter/src/behaviour-depth.hg   |    8 ++++++++
 clutter/src/behaviour-ellipse.hg |    8 ++++++++
 clutter/src/behaviour-opacity.hg |    9 +++++++++
 clutter/src/behaviour-path.hg    |    9 +++++++++
 clutter/src/behaviour-rotate.hg  |    9 +++++++++
 clutter/src/behaviour-scale.hg   |    8 ++++++++
 clutter/src/behaviour.hg         |    8 ++++++++
 7 files changed, 59 insertions(+), 0 deletions(-)
---
diff --git a/clutter/src/behaviour-depth.hg b/clutter/src/behaviour-depth.hg
index c4d9641..1d84dab 100644
--- a/clutter/src/behaviour-depth.hg
+++ b/clutter/src/behaviour-depth.hg
@@ -21,13 +21,21 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(cluttermm/private/behaviour_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
 
 namespace Clutter
 {
 
+/**
+ * @deprecated Use Actor::animate() with the Actor's depth
+ * property instead.
+ */
 class BehaviourDepth : public Behaviour
 {
   _CLASS_GOBJECT(BehaviourDepth, ClutterBehaviourDepth, CLUTTER_BEHAVIOUR_DEPTH, Behaviour, ClutterBehaviour)
+  _IS_DEPRECATED
 
 protected:
   _WRAP_CTOR(BehaviourDepth(const Glib::RefPtr<Alpha>& alpha, int depth_start, int depth_end), 
clutter_behaviour_depth_new)
diff --git a/clutter/src/behaviour-ellipse.hg b/clutter/src/behaviour-ellipse.hg
index 7580686..3fa1317 100644
--- a/clutter/src/behaviour-ellipse.hg
+++ b/clutter/src/behaviour-ellipse.hg
@@ -22,13 +22,21 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(cluttermm/private/behaviour_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
 
 namespace Clutter
 {
 
+/**
+ * @deprecated Behaviour and its sub-classes have been deprecated since Clutter
+ * 1.6, in favour of the animation framework API.
+ */
 class BehaviourEllipse : public Behaviour
 {
   _CLASS_GOBJECT(BehaviourEllipse, ClutterBehaviourEllipse, CLUTTER_BEHAVIOUR_ELLIPSE, Behaviour, 
ClutterBehaviour)
+  _IS_DEPRECATED
 
 protected:
   //Hand-coded because x and y must be combined into one ClutterKnot center parameter.
diff --git a/clutter/src/behaviour-opacity.hg b/clutter/src/behaviour-opacity.hg
index 2bdbe52..7954b88 100644
--- a/clutter/src/behaviour-opacity.hg
+++ b/clutter/src/behaviour-opacity.hg
@@ -22,13 +22,22 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(cluttermm/private/behaviour_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
 
 namespace Clutter
 {
 
+//TODO: Wrap state.
+/**
+ * @deprecated Use Actor::animate() with the Actor's opacity property,
+ * or Animator, or State instead.
+ */
 class BehaviourOpacity : public Behaviour
 {
   _CLASS_GOBJECT(BehaviourOpacity, ClutterBehaviourOpacity, CLUTTER_BEHAVIOUR_OPACITY, Behaviour, 
ClutterBehaviour)
+  _IS_DEPRECATED
 
 protected:
   _WRAP_CTOR(BehaviourOpacity(const Glib::RefPtr<Alpha>& alpha, guint8 opacity_start, guint8 opacity_end), 
clutter_behaviour_opacity_new)
diff --git a/clutter/src/behaviour-path.hg b/clutter/src/behaviour-path.hg
index af0e962..28a3bd1 100644
--- a/clutter/src/behaviour-path.hg
+++ b/clutter/src/behaviour-path.hg
@@ -1,3 +1,4 @@
+
 /* Copyright (C) 2007 The cluttermm Development Team
  *
  * This library is free software; you can redistribute it and/or
@@ -24,14 +25,22 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(cluttermm/private/behaviour_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
+
 namespace Clutter
 {
 
+/**
+ * @deprecated Use Path and PathConstraint with Actor::animate() instead.
+ */
 class BehaviourPath
 : public Behaviour,
   public Scriptable
 {
   _CLASS_GOBJECT(BehaviourPath, ClutterBehaviourPath, CLUTTER_BEHAVIOUR_PATH, Behaviour, ClutterBehaviour)
+  _IS_DEPRECATED
   _IMPLEMENTS_INTERFACE(Scriptable)
 
 protected:
diff --git a/clutter/src/behaviour-rotate.hg b/clutter/src/behaviour-rotate.hg
index 4d16132..fdc454e 100644
--- a/clutter/src/behaviour-rotate.hg
+++ b/clutter/src/behaviour-rotate.hg
@@ -22,13 +22,22 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(cluttermm/private/behaviour_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
 
 namespace Clutter
 {
 
+/**
+ * @deprecated Use the Actor rotation properties and
+ * Actor::animate(), or Animator, or State
+ * instead.
+ */
 class BehaviourRotate : public Behaviour
 {
   _CLASS_GOBJECT(BehaviourRotate, ClutterBehaviourRotate, CLUTTER_BEHAVIOUR_ROTATE, Behaviour, 
ClutterBehaviour)
+  _IS_DEPRECATED
 
 protected:
   _WRAP_CTOR(BehaviourRotate(const Glib::RefPtr<Alpha>& alpha, RotateAxis axis, RotateDirection direction, 
double angle_begin, double angle_end), clutter_behaviour_rotate_new)
diff --git a/clutter/src/behaviour-scale.hg b/clutter/src/behaviour-scale.hg
index 229ee4e..1adf1d5 100644
--- a/clutter/src/behaviour-scale.hg
+++ b/clutter/src/behaviour-scale.hg
@@ -22,13 +22,21 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(cluttermm/private/behaviour_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
 
 namespace Clutter
 {
 
+/**
+ * @deprecated Use the Actor's scale-x and scale-y  properties, with Actor::animate(),
+ * or Animator or State instead.
+ */
 class BehaviourScale : public Behaviour
 {
   _CLASS_GOBJECT(BehaviourScale, ClutterBehaviourScale, CLUTTER_BEHAVIOUR_SCALE, Behaviour, ClutterBehaviour)
+  _IS_DEPRECATED
 
 protected:
   _WRAP_CTOR(BehaviourScale(const Glib::RefPtr<Alpha>& alpha, double x_scale_start, double y_scale_start, 
double x_scale_end, double y_scale_end), clutter_behaviour_scale_new)
diff --git a/clutter/src/behaviour.hg b/clutter/src/behaviour.hg
index 71cd745..7d12ea8 100644
--- a/clutter/src/behaviour.hg
+++ b/clutter/src/behaviour.hg
@@ -21,13 +21,21 @@
 _DEFS(cluttermm,clutter)
 _PINCLUDE(glibmm/private/object_p.h)
 
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#define CLUTTER_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
 
 namespace Clutter
 {
 
+/**
+ * @deprecated Behaviour and its sub-classes have been deprecated since Clutter
+ * 1.6, in favour of the animation framework API.
+ */
 class Behaviour : public Glib::Object
 {
   _CLASS_GOBJECT(Behaviour, ClutterBehaviour, CLUTTER_BEHAVIOUR, Glib::Object, GObject)
+  _IS_DEPRECATED
 
 protected:
   _CTOR_DEFAULT()