luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-10-31 16:32:18 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'instantiatable' into 'master'

Browse Source 
gobject: Standardise on the term ‘instantiatable’

See merge request GNOME/glib!1735
This commit is contained in:
Sebastian Dröge
2020-11-13 15:29:07 +00:00
parent e4721dfff5 4f2b1e250d
commit ddef9ba2f8
9 changed files with 37 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/reference/gio/gdbus-codegen.xml
View File

@@ -90,7 +90,7 @@
When generating C code, a
#GInterface<!-- -->-derived type is generated for each D-Bus
interface. Additionally, for every generated type,
<type>FooBar</type>, two concrete instantiable types,
<type>FooBar</type>, two concrete instantiatable types,
<type>FooBarProxy</type> and <type>FooBarSkeleton</type>, implementing
said interface are also generated. The former is derived from
#GDBusProxy and intended for use on the client side
@@ -771,7 +771,7 @@ gdbus-codegen --generate-c-code myapp-generated \
<filename>myapp-generated.[ch]</filename> are
generated. The files provide an abstract
#GTypeInterface<!-- -->-derived type called
<type>MyAppFrobber</type> as well as two instantiable types with
<type>MyAppFrobber</type> as well as two instantiatable types with
the same name but suffixed with <type>Proxy</type> and
<type>Skeleton</type>. The generated file, roughly, contains the
following facilities:

6
docs/reference/gobject/tut_gobject.xml
View File

@@ -12,7 +12,7 @@
</para>
<para>
<link linkend="GObject"><type>GObject</type></link> is a fundamental classed instantiable type. It implements:
<link linkend="GObject"><type>GObject</type></link> is a fundamental classed instantiatable type. It implements:
<itemizedlist>
<listitem><para>Memory management with reference counting</para></listitem>
<listitem><para>Construction/Destruction of instances</para></listitem>
@@ -293,8 +293,8 @@ ViewerFile *file = g_object_new (VIEWER_TYPE_FILE, NULL);
one of the <function>g_type_register_*</function> functions), the object's instance
memory will be freed or returned to the object pool for this type.
Once the object has been freed, if it was the last instance of the type, the type's class
will be destroyed as described in <xref linkend="gtype-instantiable-classed"/> and
<xref linkend="gtype-non-instantiable-classed"/>.
will be destroyed as described in <xref linkend="gtype-instantiatable-classed"/> and
<xref linkend="gtype-non-instantiatable-classed"/>.
</para>
<para>

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

@@ -108,7 +108,7 @@ GType g_type_register_fundamental (GType type_id,
<para>
The major common point between <emphasis>all</emphasis> GLib types (fundamental and
non-fundamental, classed and non-classed, instantiable and non-instantiable) is that
non-fundamental, classed and non-classed, instantiatable and non-instantiatable) is that
they can all be manipulated through a single API to copy/assign them.
</para>
@@ -300,11 +300,11 @@ GType viewer_file_get_type (void)
</sect1>
<sect1 id="gtype-non-instantiable">
<title>Non-instantiable non-classed fundamental types</title>
<sect1 id="gtype-non-instantiatable">
<title>Non-instantiatable non-classed fundamental types</title>
<para>
A lot of types are not instantiable by the type system and do not have
A lot of types are not instantiatable by the type system and do not have
a class. Most of these types are fundamental trivial types such as <emphasis>gchar</emphasis>,
and are already registered by GLib.
</para>
@@ -344,7 +344,7 @@ GType viewer_file_get_type (void)
<para>
Having non-instantiable types might seem a bit useless: what good is a type
Having non-instantiatable types might seem a bit useless: what good is a type
if you cannot instantiate an instance of that type ? Most of these types
are used in conjunction with <link linkend="GValue"><type>GValue</type></link>s: a GValue is initialized
with an integer or a string and it is passed around by using the registered
@@ -354,8 +354,8 @@ GType viewer_file_get_type (void)
</sect1>
<sect1 id="gtype-instantiable-classed">
<title>Instantiable classed types: objects</title>
<sect1 id="gtype-instantiatable-classed">
<title>Instantiatable classed types: objects</title>
<para>
This section covers the theory behind objects. See
@@ -364,10 +364,10 @@ GType viewer_file_get_type (void)
</para>
<para>
Types which are registered with a class and are declared instantiable are
Types which are registered with a class and are declared instantiatable are
what most closely resembles an <emphasis>object</emphasis>.
Although <link linkend="GObject"><type>GObject</type></link>s (detailed in <xref linkend="chapter-gobject"/>)
are the most well known type of instantiable
are the most well known type of instantiatable
classed types, other kinds of similar objects used as the base of an inheritance
hierarchy have been externally developed and they are all built on the fundamental
features described below.
@@ -498,7 +498,7 @@ B *b;
</programlisting></informalexample>
</para>
<sect2 id="gtype-instantiable-classed-init-done">
<sect2 id="gtype-instantiatable-classed-init-done">
<title>Initialization and Destruction</title>
<para>
@@ -599,7 +599,7 @@ B *b;
<row>
<!--entry>First call to <function><link linkend="g-type-create-instance">g_type_create_instance</link></function> for target type</entry-->
<entry>interface initialization, see
<xref linkend="gtype-non-instantiable-classed-init"/></entry>
<xref linkend="gtype-non-instantiatable-classed-init"/></entry>
<entry></entry>
</row>
<row>
@@ -610,7 +610,7 @@ B *b;
<row>
<entry morerows="2">Last call to <function><link linkend="g-type-free-instance">g_type_free_instance</link></function> for target type</entry>
<entry>interface destruction, see
<xref linkend="gtype-non-instantiable-classed-dest"/></entry>
<xref linkend="gtype-non-instantiatable-classed-dest"/></entry>
<entry></entry>
</row>
<row>
@@ -633,8 +633,8 @@ B *b;
</sect1>
<sect1 id="gtype-non-instantiable-classed">
<title>Non-instantiable classed types: interfaces</title>
<sect1 id="gtype-non-instantiatable-classed">
<title>Non-instantiatable classed types: interfaces</title>
<para>
This section covers the theory behind interfaces. See
@@ -648,7 +648,7 @@ B *b;
Imagine the play, pause and stop buttons on hi-fi equipment — those can
be seen as a playback interface. Once you know what they do, you can
control your CD player, MP3 player or anything that uses these symbols.
To declare an interface you have to register a non-instantiable
To declare an interface you have to register a non-instantiatable
classed type which derives from
<link linkend="GTypeInterface"><type>GTypeInterface</type></link>. The following piece of code declares such an interface.
<informalexample><programlisting>
@@ -792,14 +792,14 @@ struct _GInterfaceInfo
</programlisting></informalexample>
</para>
<sect2 id="gtype-non-instantiable-classed-init">
<sect2 id="gtype-non-instantiatable-classed-init">
<title>Interface Initialization</title>
<para>
When an instantiable classed type which implements an interface
When an instantiatable classed type which implements an interface
(either directly or by inheriting an implementation from a superclass)
is created for the first time, its class structure is initialized
following the process described in <xref linkend="gtype-instantiable-classed"/>.
following the process described in <xref linkend="gtype-instantiatable-classed"/>.
After that, the interface implementations associated with
the type are initialized.
</para>
@@ -937,11 +937,11 @@ viewer_editable_default_init (ViewerEditableInterface *iface)
</sect2>
<sect2 id="gtype-non-instantiable-classed-dest">
<sect2 id="gtype-non-instantiatable-classed-dest">
<title>Interface Destruction</title>
<para>
When the last instance of an instantiable type which registered
When the last instance of an instantiatable type which registered
an interface implementation is destroyed, the interface's
implementations associated to the type are destroyed.
</para>
@@ -955,7 +955,7 @@ viewer_editable_default_init (ViewerEditableInterface *iface)
<para>
Again, it is important to understand, as in
<xref linkend="gtype-non-instantiable-classed-init"/>,
<xref linkend="gtype-non-instantiatable-classed-init"/>,
that both <function>interface_finalize</function> and <function>base_finalize</function>
are invoked exactly once for the destruction of each implementation of an interface. Thus,
if you were to use one of these functions, you would need to use a static integer variable

2
docs/reference/gobject/tut_howto.xml
View File

@@ -854,7 +854,7 @@ b_method_to_call (B *obj, gint some_param)
<para>
The theory behind how GObject interfaces work is given in
<xref linkend="gtype-non-instantiable-classed"/>; this section covers how to
<xref linkend="gtype-non-instantiatable-classed"/>; this section covers how to
define and implement an interface.
</para>

4
gobject/gobject.c
View File

@@ -48,8 +48,8 @@
* For a tutorial on implementing a new GObject class, see [How to define and
* implement a new GObject][howto-gobject]. For a list of naming conventions for
* GObjects and their methods, see the [GType conventions][gtype-conventions].
* For the high-level concepts behind GObject, read [Instantiable classed types:
* Objects][gtype-instantiable-classed].
* For the high-level concepts behind GObject, read [Instantiatable classed types:
* Objects][gtype-instantiatable-classed].
*
* ## Floating references # {#floating-ref}
*

10
gobject/gtype.c
View File

@@ -2169,7 +2169,7 @@ type_class_init_Wm (TypeNode *node,
TypeNode *bnode, *pnode;
guint i;
/* Accessing data->class will work for instantiable types
/* Accessing data->class will work for instantiatable types
* too because ClassData is a subset of InstanceData
*/
g_assert (node->is_classed && node->data &&
@@ -2868,12 +2868,12 @@ g_type_register_dynamic (GType parent_type,
/**
* g_type_add_interface_static:
* @instance_type: #GType value of an instantiable type
* @instance_type: #GType value of an instantiatable type
* @interface_type: #GType value of an interface type
* @info: #GInterfaceInfo structure for this
* (@instance_type, @interface_type) combination
*
* Adds @interface_type to the static @instantiable_type.
* Adds @interface_type to the static @instance_type.
* The information contained in the #GInterfaceInfo structure
* pointed to by @info is used to manage the relationship.
*/
@@ -2905,11 +2905,11 @@ g_type_add_interface_static (GType instance_type,
/**
* g_type_add_interface_dynamic:
* @instance_type: #GType value of an instantiable type
* @instance_type: #GType value of an instantiatable type
* @interface_type: #GType value of an interface type
* @plugin: #GTypePlugin structure to retrieve the #GInterfaceInfo from
*
* Adds @interface_type to the dynamic @instantiable_type. The information
* Adds @interface_type to the dynamic @instance_type. The information
* contained in the #GTypePlugin structure pointed to by @plugin
* is used to manage the relationship.
*/

2
gobject/gtype.h
View File

@@ -981,7 +981,7 @@ typedef void (*GTypeInterfaceCheckFunc) (gpointer check_data,
/**
* GTypeFundamentalFlags:
* @G_TYPE_FLAG_CLASSED: Indicates a classed type
* @G_TYPE_FLAG_INSTANTIATABLE: Indicates an instantiable type (implies classed)
* @G_TYPE_FLAG_INSTANTIATABLE: Indicates an instantiatable type (implies classed)
* @G_TYPE_FLAG_DERIVABLE: Indicates a flat derivable type
* @G_TYPE_FLAG_DEEP_DERIVABLE: Indicates a deep derivable type (implies derivable)
*

2
gobject/gtypeplugin.c
View File

@@ -167,7 +167,7 @@ g_type_plugin_complete_type_info (GTypePlugin *plugin,
/**
* g_type_plugin_complete_interface_info:
* @plugin: the #GTypePlugin
* @instance_type: the #GType of an instantiable type to which the interface
* @instance_type: the #GType of an instantiatable type to which the interface
* is added
* @interface_type: the #GType of the interface whose info is completed
* @info: the #GInterfaceInfo to fill in

2
gobject/gtypeplugin.h
View File

@@ -67,7 +67,7 @@ typedef void (*GTypePluginCompleteTypeInfo) (GTypePlugin *plugin,
/**
* GTypePluginCompleteInterfaceInfo:
* @plugin: the #GTypePlugin
* @instance_type: the #GType of an instantiable type to which the interface
* @instance_type: the #GType of an instantiatable type to which the interface
* is added
* @interface_type: the #GType of the interface whose info is completed
* @info: the #GInterfaceInfo to fill in