Add deprecation info.

1 files changed, 6 insertions, 20 deletions

diff --git a/docs/reference/gtk/tmpl/gtktypeutils.sgml b/docs/reference/gtk/tmpl/gtktypeutils.sgml
index 0915b3203..84a3bf7da 100644
--- a/docs/reference/gtk/tmpl/gtktypeutils.sgml
+++ b/docs/reference/gtk/tmpl/gtktypeutils.sgml
@@ -37,7 +37,7 @@ Returns the type name of @class.
 </para>
 
 @class: a #GtkTypeClass.
-
+@Deprecated: Use g_type_name() and G_TYPE_FROM_CLASS() instead.
 
 <!-- ##### MACRO GTK_CLASS_TYPE ##### -->
 <para>
@@ -45,7 +45,7 @@ Returns the type of @class.
 </para>
 
 @class: a #GtkTypeClass.
-
+@Deprecated: Use G_TYPE_FROM_CLASS() instead.
 
 <!-- ##### MACRO GTK_TYPE_IS_OBJECT ##### -->
 <para>
@@ -53,31 +53,28 @@ Returns %TRUE if @type is a %GTK_TYPE_OBJECT.
 </para>
 
 @type: a #GtkType.
-
+@Deprecated: Use G_TYPE_IS_OBJECT() instead.
 
 <!-- ##### MACRO GTK_TYPE_FUNDAMENTAL_LAST ##### -->
 <para>
 The highest-numbered structured or flat enumerated type value.
 </para>
 
-
+@Deprecated: Use #G_TYPE_LAST_RESERVED_FUNDAMENTAL - 1 instead.
 
 <!-- ##### MACRO GTK_TYPE_FUNDAMENTAL_MAX ##### -->
 <para>
 The maximum fundamental enumerated type value.
 </para>
 
-
+@Deprecated: Use #G_TYPE_FUNDAMENTAL_MAX instead.
 
 <!-- ##### MACRO GTK_STRUCT_OFFSET ##### -->
 <para>
 Use in place of <function>offsetof()</function>, which is used if it exists.
 </para>
 
-<!-- # Unused Parameters # -->
-@struct: The type of the structure.
-@field: The field within the structure.
-
+@Deprecated: Use G_STRUCT_OFFSET() instead.
 
 <!-- ##### MACRO GTK_CHECK_CAST ##### -->
 <para>
@@ -86,12 +83,6 @@ defined, just cast it.  Otherwise, check to see if we can cast @tobj
 into a @cast.
 </para>
 
-<!-- # Unused Parameters # -->
-@tobj: a #GtkObject.
-@cast_type: a GTK+ type.
-@cast: a C type
-
-
 <!-- ##### MACRO GTK_CHECK_CLASS_CAST ##### -->
 <para>
 Casts the object in @tobj into @cast.  If %G_DISABLE_CAST_CHECKS is
@@ -99,7 +90,6 @@ defined, just cast it.  Otherwise, check to see if we can cast @tobj
 into a @cast.
 </para>
 
-<!-- # Unused Parameters # -->
 @tclass: a #GtkClassInitFunc
 @cast_type: a GTK+ type.
 @cast: a C type
@@ -110,7 +100,6 @@ into a @cast.
 Determines whether @type_object is a type of @otype.
 </para>
 
-<!-- # Unused Parameters # -->
 @type_object: a #GtkTypeObject object
 @otype: 
 
@@ -120,7 +109,6 @@ Determines whether @type_object is a type of @otype.
 Determines whether @type_class is a type of @otype.
 </para>
 
-<!-- # Unused Parameters # -->
 @type_class: a #GtkTypeClass class.
 @otype: 
 
@@ -130,7 +118,6 @@ Determines whether @type_class is a type of @otype.
 Gets the class of @tobj.
 </para>
 
-<!-- # Unused Parameters # -->
 @tobj: a #GtkObject.
 
 
@@ -139,7 +126,6 @@ Gets the class of @tobj.
 Converts a GTK+ type into a fundamental type.
 </para>
 
-<!-- # Unused Parameters # -->
 @type: