From 79de2a622fb319253c01b83a172aa9752feff189 Mon Sep 17 00:00:00 2001 From: Rico Tzschichholz Date: Mon, 24 Sep 2012 09:24:36 +0200 Subject: [PATCH] Update annotations to glib 2.34.0 --- gir/gio-2.0.c | 40 +++++++++++++++++++++++++++------------- gir/glib-2.0.c | 9 +++++---- gir/gobject-2.0.c | 5 ++++- 3 files changed, 36 insertions(+), 18 deletions(-) diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 2ac8e197..3f3b2222 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -3460,6 +3460,19 @@ * applications this is the always the current instance. * On Linux, the D-Bus session bus is used for communication. * + * The use of #GApplication differs from some other commonly-used + * uniqueness libraries (such as libunique) in important ways. The + * application is not expected to manually register itself and check if + * it is the primary instance. Instead, the main() + * function of a #GApplication should do very little more than + * instantiating the application instance, possibly connecting signal + * handlers, then calling g_application_run(). All checks for + * uniqueness are done internally. If the application is the primary + * instance then the startup signal is emitted and the mainloop runs. + * If the application is not the primary instance then a signal is sent + * to the primary instance and g_application_run() promptly returns. + * See the code examples below. + * * If used, the expected form of an application identifier is very close * to that of of a * DBus bus name. @@ -10532,23 +10545,23 @@ /** * g_async_result_is_tagged: - * @result: a #GAsyncResult + * @res: a #GAsyncResult * @source_tag: an application-defined tag * - * Checks if @result has the given @source_tag (generally a function - * pointer indicating the function @result was created by). + * Checks if @res has the given @source_tag (generally a function + * pointer indicating the function @res was created by). * - * Returns: %TRUE if @result has the indicated @source_tag, %FALSE if not. + * Returns: %TRUE if @res has the indicated @source_tag, %FALSE if not. * Since: 2.34 */ /** * g_async_result_legacy_propagate_error: - * @result: a #GAsyncResult - * @dest: (out): a location to propagate the error to. + * @res: a #GAsyncResult + * @error: (out): a location to propagate the error to. * - * If @result is a #GSimpleAsyncResult, this is equivalent to + * If @res is a #GSimpleAsyncResult, this is equivalent to * g_simple_async_result_propagate_error(). Otherwise it returns * %FALSE. * @@ -16511,11 +16524,11 @@ /** * g_desktop_app_info_get_startup_wm_class: - * @app_info: a #GDesktopAppInfo that supports startup notify + * @info: a #GDesktopAppInfo that supports startup notify * - * Retrieves the StartupWMClass field from @app_info. This represents the - * WM_CLASS property of the main window of the application, if launched through - * @app_info. + * Retrieves the StartupWMClass field from @info. This represents the + * WM_CLASS property of the main window of the application, if launched + * through @info. * * Returns: (transfer none): the startup WM class, or %NULL if none is set in the desktop file. * Since: 2.34 @@ -17618,7 +17631,7 @@ /** * g_file_delete_finish: * @file: input #GFile - * @res: a #GAsyncResult + * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes deleting a file started with g_file_delete_async(). @@ -30333,7 +30346,7 @@ * g_test_dbus_get_flags: * @self: a #GTestDBus * - * + * Gets the flags of the #GTestDBus object. * * Returns: the value of #GTestDBus:flags property */ @@ -32395,6 +32408,7 @@ /** * g_unix_mount_point_guess_symbolic_icon: + * @mount_point: a #GUnixMountPoint * * Guesses the symbolic icon of a Unix mount point. * diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index 76f9bcd7..90ec0003 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -369,6 +369,7 @@ /** * GDuplicateFunc: * @data: the data to duplicate + * @user_data: user data that was specified in g_datalist_id_dup_data() * * The type of functions that are used to 'duplicate' an object. * What this means depends on the context, it could just be @@ -21332,12 +21333,12 @@ /** * g_ptr_array_ref: - * @array: A #GArray. + * @array: a #GPtrArray * - * Atomically increments the reference count of @array by one. This - * function is MT-safe and may be called from any thread. + * Atomically increments the reference count of @array by one. + * This function is thread-safe and may be called from any thread. * - * Returns: The passed in #GPtrArray. + * Returns: The passed in #GPtrArray * Since: 2.22 */ diff --git a/gir/gobject-2.0.c b/gir/gobject-2.0.c index 2c1ae39e..81e65a32 100644 --- a/gir/gobject-2.0.c +++ b/gir/gobject-2.0.c @@ -4599,7 +4599,10 @@ * (such as the various fundamental type implementations or the signal * system). * - * This function is idempotent. + * This function is idempotent: If you call it multiple times, all but + * the first calls will be silently ignored. + * + * There is no way to undo the effect of g_type_init(). * * Since version 2.24 this also initializes the thread system */ -- 2.34.1