luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-04-01 13:23:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

Remove the questionable closing sentence and all references to private

Browse Source 
* gobject/tut_gtype.xml: Remove the questionable closing sentence
        and all references to private functions. Pointed out by Christian
        Dywan.


svn path=/trunk/; revision=7711
This commit is contained in:
Matthias Clasen 2008-12-01 03:13:46 +00:00
parent 5d5526c1a3
commit 7570db065a
2 changed files with 24 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/reference/ChangeLog
View File

@ -1,3 +1,12 @@
2008-11-30 Matthias Clasen <mclasen@redhat.com>
Bug 562538 – GObject interface tutorial shouldn't finalise with
"Please forget everything"
* gobject/tut_gtype.xml: Remove the questionable closing sentence
and all references to private functions. Pointed out by Christian
Dywan.
2008-11-28 Matthias Clasen <mclasen@redhat.com> 2008-11-28 Matthias Clasen <mclasen@redhat.com>
Bug 559452 – GObject Reference Manual (typo) Bug 559452 – GObject Reference Manual (typo)

50
docs/reference/gobject/tut_gtype.xml
View File

@ -540,12 +540,6 @@ void g_type_free_instance (GTypeInstance *instance);
initialization of the class structure. initialization of the class structure.
Finally, the object's interfaces are initialized (we will discuss interface initialization Finally, the object's interfaces are initialized (we will discuss interface initialization
in more detail later). in more detail later).
<footnote id="class-init">
<para>
The class initialization process is entirely implemented in
<function>type_class_init_Wm</function> in <filename>gtype.c</filename>.
</para>
</footnote>
</para> </para>
<para> <para>
@ -563,15 +557,9 @@ void g_type_free_instance (GTypeInstance *instance);
<para> <para>
Class destruction Class destruction (the concept of destruction is sometimes partly
<footnote> referred to as finalization in GType) is the symmetric process of
<para>It is implemented in <function>type_data_finalize_class_U</function> the initialization: interfaces are destroyed first.
(in <filename>gtype.c</filename>.
</para>
</footnote>
(the concept of destruction is sometimes partly referred to as finalization
in GType) is the symmetric process of the initialization: interfaces are
destroyed first.
Then, the most derived Then, the most derived
class_finalize (<type><link linkend="ClassFinalizeFunc">ClassFinalizeFunc</link></type>) function is invoked. The class_finalize (<type><link linkend="ClassFinalizeFunc">ClassFinalizeFunc</link></type>) function is invoked. The
base_class_finalize (<type><link linkend="GBaseFinalizeFunc">GBaseFinalizeFunc</link></type>) functions are base_class_finalize (<type><link linkend="GBaseFinalizeFunc">GBaseFinalizeFunc</link></type>) functions are
@ -784,13 +772,12 @@ struct _GInterfaceInfo
<title>Interface Initialization</title> <title>Interface Initialization</title>
<para> <para>
When an instantiable classed type which registered an interface implementation When an instantiable classed type which registered an interface
is created for the first time, its class structure is initialized following the process implementation is created for the first time, its class structure
described in <xref linkend="gtype-instantiable-classed"/>. Once the class structure is is initialized following the process
initialized, the function <function>type_class_init_Wm</function> (implemented in <filename> described in <xref linkend="gtype-instantiable-classed"/>.
gtype.c</filename>) initializes the interface implementations associated with After that, the interface implementations associated with
that type by calling <function>type_iface_vtable_init_Wm</function> for each the type are initialized.
interface.
</para> </para>
<para> <para>
@ -889,14 +876,15 @@ maman_ibaz_base_init (gpointer g_iface)
<title>Interface Destruction</title> <title>Interface Destruction</title>
<para> <para>
When the last instance of an instantiable type which registered an interface implementation When the last instance of an instantiable type which registered
is destroyed, the interface's implementations associated to the type are destroyed by an interface implementation is destroyed, the interface's
<function>type_iface_vtable_finalize_Wm</function> (in <filename>gtype.c</filename>). implementations associated to the type are destroyed.
</para> </para>
<para> <para>
<function>type_iface_vtable_finalize_Wm</function> invokes first the implementation's To destroy an interface implementation, GType first calls the
<function>interface_finalize</function> function and then the interface's most-derived implementation's <function>interface_finalize</function> function
and then the interface's most-derived
<function>base_finalize</function> function. <function>base_finalize</function> function.
</para> </para>
@ -945,14 +933,6 @@ maman_ibaz_base_init (gpointer g_iface)
</tgroup> </tgroup>
</table> </table>
</para> </para>
<para>
Now that you have read this section, you can forget about it. Please, forget it
<emphasis>as soon as possible</emphasis>.
</para>
</sect2> </sect2>
</sect1> </sect1>
</chapter> </chapter>