luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-09-28 01:57:14 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Move the GInitable SECTION

Browse Source 
Move it to the struct docs.

Signed-off-by: Philip Withnall <philip@tecnocode.co.uk>

Helps: #3037
This commit is contained in:
Philip Withnall
2023-10-23 00:27:17 +01:00
parent 824ae3f931
commit 92d8da4895
2 changed files with 14 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
gio/ginitable.c
View File

@@ -26,35 +26,34 @@
/** /**
* SECTION:ginitable * GInitable:
* @short_description: Failable object initialization interface
* @include: gio/gio.h
* @see_also: #GAsyncInitable
* *
* #GInitable is implemented by objects that can fail during * `GInitable` is implemented by objects that can fail during
* initialization. If an object implements this interface then * initialization. If an object implements this interface then
* it must be initialized as the first thing after construction, * it must be initialized as the first thing after construction,
* either via g_initable_init() or g_async_initable_init_async() * either via [method@Gio.Initable.init] or [method@Gio.AsyncInitable.init_async]
* (the latter is only available if it also implements #GAsyncInitable). * (the latter is only available if it also implements [iface@Gio.AsyncInitable]).
* *
* If the object is not initialized, or initialization returns with an * If the object is not initialized, or initialization returns with an
* error, then all operations on the object except g_object_ref() and * error, then all operations on the object except `g_object_ref()` and
* g_object_unref() are considered to be invalid, and have undefined * `g_object_unref()` are considered to be invalid, and have undefined
* behaviour. They will often fail with g_critical() or g_warning(), but * behaviour. They will often fail with [func@GLib.critical] or
* this must not be relied on. * [func@GLib.warning], but this must not be relied on.
* *
* Users of objects implementing this are not intended to use * Users of objects implementing this are not intended to use
* the interface method directly, instead it will be used automatically * the interface method directly, instead it will be used automatically
* in various ways. For C applications you generally just call * in various ways. For C applications you generally just call
* g_initable_new() directly, or indirectly via a foo_thing_new() wrapper. * [func@Gio.Initable.new] directly, or indirectly via a `foo_thing_new()` wrapper.
* This will call g_initable_init() under the cover, returning %NULL and * This will call [method@Gio.Initable.init] under the cover, returning `NULL`
* setting a #GError on failure (at which point the instance is * and setting a `GError` on failure (at which point the instance is
* unreferenced). * unreferenced).
* *
* For bindings in languages where the native constructor supports * For bindings in languages where the native constructor supports
* exceptions the binding could check for objects implementing %GInitable * exceptions the binding could check for objects implementing `GInitable`
* during normal construction and automatically initialize them, throwing * during normal construction and automatically initialize them, throwing
* an exception on failure. * an exception on failure.
*
* Since: 2.22
*/ */
typedef GInitableIface GInitableInterface; typedef GInitableIface GInitableInterface;

7
gio/ginitable.h
View File

@@ -37,13 +37,6 @@ G_BEGIN_DECLS
#define G_INITABLE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_INITABLE, GInitableIface)) #define G_INITABLE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_INITABLE, GInitableIface))
#define G_TYPE_IS_INITABLE(type) (g_type_is_a ((type), G_TYPE_INITABLE)) #define G_TYPE_IS_INITABLE(type) (g_type_is_a ((type), G_TYPE_INITABLE))
/**
* GInitable:
*
* Interface for initializable objects.
*
* Since: 2.22
**/
typedef struct _GInitableIface GInitableIface; typedef struct _GInitableIface GInitableIface;
/** /**