summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSebastian Dröge <slomo@coaxion.net>2020-11-13 15:29:07 +0000
committerSebastian Dröge <slomo@coaxion.net>2020-11-13 15:29:07 +0000
commitddef9ba2f8a0d8d0aadef527652c63fbac799114 (patch)
tree052c0ac51d6ea51495b0981e649293b70056a1dd
parente4721dfff524de27e494ff641da3beab6db977f8 (diff)
parent4f2b1e250d047b94022e6bf80e880c77a4f1c2e8 (diff)
downloadglib-ddef9ba2f8a0d8d0aadef527652c63fbac799114.tar.gz
Merge branch 'instantiatable' into 'master'
gobject: Standardise on the term ‘instantiatable’ See merge request GNOME/glib!1735
-rw-r--r--docs/reference/gio/gdbus-codegen.xml4
-rw-r--r--docs/reference/gobject/tut_gobject.xml6
-rw-r--r--docs/reference/gobject/tut_gtype.xml42
-rw-r--r--docs/reference/gobject/tut_howto.xml2
-rw-r--r--gobject/gobject.c4
-rw-r--r--gobject/gtype.c10
-rw-r--r--gobject/gtype.h2
-rw-r--r--gobject/gtypeplugin.c2
-rw-r--r--gobject/gtypeplugin.h2
9 files changed, 37 insertions, 37 deletions
diff --git a/docs/reference/gio/gdbus-codegen.xml b/docs/reference/gio/gdbus-codegen.xml
index 25210c3c4..960b5ffa0 100644
--- a/docs/reference/gio/gdbus-codegen.xml
+++ b/docs/reference/gio/gdbus-codegen.xml
@@ -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:
diff --git a/docs/reference/gobject/tut_gobject.xml b/docs/reference/gobject/tut_gobject.xml
index fc7d6fe16..d1cb41f71 100644
--- a/docs/reference/gobject/tut_gobject.xml
+++ b/docs/reference/gobject/tut_gobject.xml
@@ -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>
diff --git a/docs/reference/gobject/tut_gtype.xml b/docs/reference/gobject/tut_gtype.xml
index a1c6005a0..25e37dc48 100644
--- a/docs/reference/gobject/tut_gtype.xml
+++ b/docs/reference/gobject/tut_gtype.xml
@@ -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
diff --git a/docs/reference/gobject/tut_howto.xml b/docs/reference/gobject/tut_howto.xml
index bfb8d95c5..b61a328b6 100644
--- a/docs/reference/gobject/tut_howto.xml
+++ b/docs/reference/gobject/tut_howto.xml
@@ -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>
diff --git a/gobject/gobject.c b/gobject/gobject.c
index d8a31a3df..6e9c44a1e 100644
--- a/gobject/gobject.c
+++ b/gobject/gobject.c
@@ -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}
*
diff --git a/gobject/gtype.c b/gobject/gtype.c
index 12ad8be28..51dad7690 100644
--- a/gobject/gtype.c
+++ b/gobject/gtype.c
@@ -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.
*/
diff --git a/gobject/gtype.h b/gobject/gtype.h
index d839e4e3a..9de46ac60 100644
--- a/gobject/gtype.h
+++ b/gobject/gtype.h
@@ -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)
*
diff --git a/gobject/gtypeplugin.c b/gobject/gtypeplugin.c
index 9068b053e..d5007f1d3 100644
--- a/gobject/gtypeplugin.c
+++ b/gobject/gtypeplugin.c
@@ -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
diff --git a/gobject/gtypeplugin.h b/gobject/gtypeplugin.h
index 482f55cae..de114fee2 100644
--- a/gobject/gtypeplugin.h
+++ b/gobject/gtypeplugin.h
@@ -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