2.9.0

[~andy/gtk] / docs / reference / gtk / tmpl / gtktypeutils.sgml

diff --git a/docs/reference/gtk/tmpl/gtktypeutils.sgml b/docs/reference/gtk/tmpl/gtktypeutils.sgml
index 7008b5006cd183607708fced2bbaccba0e7b740f..99ed66cfa30194ed6d117484d2ffe015efc443ec 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktypeutils.sgml
+++ b/docs/reference/gtk/tmpl/gtktypeutils.sgml
@@ -2,7 +2,7 @@
 Types
 
 <!-- ##### SECTION Short_Description ##### -->
-Handle run-time type creation.
+Handle run-time type creation
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -15,6 +15,9 @@ managed at runtime.
 
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### TYPEDEF GtkType ##### -->
 <para>
 #GtkType is unique integer identifying the type.  The guts of the
@@ -23,29 +26,13 @@ information about the type is held in a private struct named
 </para>
 
 
-<!-- ##### ENUM GtkFundamentalType ##### -->
+<!-- ##### TYPEDEF GtkFundamentalType ##### -->
 <para>
 #GtkFundamentalType is an enumerated type which lists all the possible
 fundamental types (e.g. <type>char</type>, <type>uchar</type>, <type>int</type>,
 <type>long</type>, <type>float</type>, etc).
 </para>
 
-@GTK_TYPE_INVALID: 
-@GTK_TYPE_NONE: 
-@GTK_TYPE_ENUM: 
-@GTK_TYPE_FLAGS: 
-@GTK_TYPE_CHAR: 
-@GTK_TYPE_UCHAR: 
-@GTK_TYPE_BOOL: 
-@GTK_TYPE_INT: 
-@GTK_TYPE_UINT: 
-@GTK_TYPE_LONG: 
-@GTK_TYPE_ULONG: 
-@GTK_TYPE_FLOAT: 
-@GTK_TYPE_DOUBLE: 
-@GTK_TYPE_STRING: 
-@GTK_TYPE_BOXED: 
-@GTK_TYPE_POINTER: 
 
 <!-- ##### MACRO GTK_CLASS_NAME ##### -->
 <para>
@@ -53,6 +40,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 ##### -->
@@ -61,6 +49,7 @@ Returns the type of @class.
 </para>
 
 @class: a #GtkTypeClass.
+@Deprecated: Use G_TYPE_FROM_CLASS() instead.
 
 
 <!-- ##### MACRO GTK_TYPE_IS_OBJECT ##### -->
@@ -69,6 +58,7 @@ 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 ##### -->
@@ -76,6 +66,7 @@ Returns %TRUE if @type is a %GTK_TYPE_OBJECT.
 The highest-numbered structured or flat enumerated type value.
 </para>
 
+@Deprecated: Use #G_TYPE_LAST_RESERVED_FUNDAMENTAL - 1 instead.
 
 
 <!-- ##### MACRO GTK_TYPE_FUNDAMENTAL_MAX ##### -->
@@ -83,6 +74,7 @@ The highest-numbered structured or flat enumerated type value.
 The maximum fundamental enumerated type value.
 </para>
 
+@Deprecated: Use #G_TYPE_FUNDAMENTAL_MAX instead.
 
 
 <!-- ##### MACRO GTK_STRUCT_OFFSET ##### -->
@@ -90,9 +82,7 @@ The maximum fundamental enumerated type value.
 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 ##### -->
@@ -102,10 +92,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 ##### -->
@@ -128,7 +114,6 @@ Determines whether @type_object is a type of @otype.
 
 <!-- # Unused Parameters # -->
 @type_object: a #GtkTypeObject object
-@otype: 
 
 
 <!-- ##### MACRO GTK_CHECK_CLASS_TYPE ##### -->
@@ -138,7 +123,6 @@ Determines whether @type_class is a type of @otype.
 
 <!-- # Unused Parameters # -->
 @type_class: a #GtkTypeClass class.
-@otype: 
 
 
 <!-- ##### MACRO GTK_CHECK_GET_CLASS ##### -->
@@ -146,6 +130,7 @@ Determines whether @type_class is a type of @otype.
 Gets the class of @tobj.
 </para>
 
+<!-- # Unused Parameters # -->
 @tobj: a #GtkObject.
 
 
@@ -154,8 +139,6 @@ Gets the class of @tobj.
 Converts a GTK+ type into a fundamental type.
 </para>
 
-<!-- # Unused Parameters # -->
-@type: 
 
 
 <!-- ##### MACRO GTK_SIGNAL_FUNC ##### -->
@@ -511,7 +494,7 @@ The base structure for a GTK+ type. Every type inherits this as a base structure
 
 <!-- ##### TYPEDEF GtkEnumValue ##### -->
 <para>
-A structure which contains a single enum value, and its name, and it's
+A structure which contains a single enum value, and its name, and its
 nickname.
 </para>