[gtk+] Remove GtkObject from the docs
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] Remove GtkObject from the docs
- Date: Mon, 27 Sep 2010 02:30:47 +0000 (UTC)
commit b81de973af1fc69875c25400f39f7237d4262350
Author: Matthias Clasen <mclasen redhat com>
Date: Sun Sep 26 22:11:13 2010 -0400
Remove GtkObject from the docs
docs/reference/gtk/gtk-docs.sgml | 1 -
docs/reference/gtk/gtk3-sections.txt | 22 ----------------------
docs/reference/gtk/question_index.sgml | 29 ++++++++++++++---------------
3 files changed, 14 insertions(+), 38 deletions(-)
---
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 33c9a3e..60bf1af 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -369,7 +369,6 @@ that is, GUI components such as #GtkButton or #GtkTextView.
<xi:include href="xml/gtkcontainer.xml" />
<xi:include href="xml/gtkmenushell.xml" />
<xi:include href="xml/gtkmisc.xml" />
- <xi:include href="xml/gtkobject.xml" />
<xi:include href="xml/gtkrange.xml" />
<xi:include href="xml/gtkwidget.xml" />
<xi:include href="xml/gtkimcontext.xml" />
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 4e77a95..cdce8d7 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -2240,28 +2240,6 @@ GtkNotebookPrivate
</SECTION>
<SECTION>
-<FILE>gtkobject</FILE>
-<TITLE>GtkObject</TITLE>
-GtkObject
-GtkObjectFlags
-GTK_OBJECT_FLAGS
-gtk_object_destroy
-<SUBSECTION Standard>
-GTK_OBJECT
-GTK_IS_OBJECT
-GTK_TYPE_OBJECT
-GTK_OBJECT_CLASS
-GTK_IS_OBJECT_CLASS
-GTK_OBJECT_GET_CLASS
-
-<SUBSECTION Private>
-gtk_object_get_type
-GTK_ARG_READWRITE
-GTK_OBJECT_SET_FLAGS
-GTK_OBJECT_UNSET_FLAGS
-</SECTION>
-
-<SECTION>
<FILE>gtkoffscreenwindow</FILE>
<TITLE>GtkOffscreenWindow</TITLE>
GtkOffscreenWindow
diff --git a/docs/reference/gtk/question_index.sgml b/docs/reference/gtk/question_index.sgml
index c8c26da..7319784 100644
--- a/docs/reference/gtk/question_index.sgml
+++ b/docs/reference/gtk/question_index.sgml
@@ -95,10 +95,10 @@ from functions?
<answer>
<para>
-See the documentation for #GObject and #GtkObject. For #GObject note
-specifically g_object_ref() and g_object_unref(). #GtkObject is a subclass
-of #GObject so the same points apply, except that it has a "floating" state
-(explained in its documentation).
+See the documentation for #GObject and #GInitiallyUnowned. For #GObject note
+specifically g_object_ref() and g_object_unref(). #GInitiallyUnowned is a
+subclass of #GObject so the same points apply, except that it has a "floating"
+state (explained in its documentation).
</para>
<para>
@@ -115,7 +115,7 @@ url="http://bugzilla.gnome.org">http://bugzilla.gnome.org</ulink>.)
<qandaentry>
<question>
<para>
-Why does my program leak memory, if I destroy a widget immediately
+Why does my program leak memory, if I destroy a widget immediately
after creating it ?
</para>
</question>
@@ -127,27 +127,26 @@ If <structname>GtkFoo</structname> isn't a toplevel window, then
foo = gtk_foo_new (<!-- -->);
gtk_widget_destroy (foo);
</programlisting></informalexample>
-is a memory leak, because no one assumed the initial floating
-reference. If you are using a widget and you aren't immediately
-packing it into a container, then you probably want standard
+is a memory leak, because no one assumed the initial floating
+reference. If you are using a widget and you aren't immediately
+packing it into a container, then you probably want standard
reference counting, not floating reference counting.
</para>
<para>
-To to get this, you must acquire a reference to the widget and drop the
-floating reference (<quote>ref and sink</quote> in GTK+ parlance) after
+To to get this, you must acquire a reference to the widget and drop the
+floating reference (<quote>ref and sink</quote> in GTK+ parlance) after
creating it:
<informalexample><programlisting>
foo = gtk_foo_new (<!-- -->);
- g_object_ref (foo);
- gtk_object_sink (GTK_OBJECT (foo));
+ g_object_ref_sink (foo);
</programlisting></informalexample>
When you want to get rid of the widget, you must call gtk_widget_destroy()
-to break any external connections to the widget before dropping your
+to break any external connections to the widget before dropping your
reference:
<informalexample><programlisting>
- gtk_widget_destroy (foo);
- g_object_unref (foo);
+ gtk_widget_destroy (foo);
+ g_object_unref (foo);
</programlisting></informalexample>
When you immediately add a widget to a container, it takes care of
assuming the initial floating reference and you don't have to worry
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]