diff options
author | Rico Tzschichholz <ricotz@ubuntu.com> | 2013-11-07 17:01:51 +0100 |
---|---|---|
committer | Rico Tzschichholz <ricotz@ubuntu.com> | 2013-11-07 17:01:51 +0100 |
commit | 96973b649ec973e8df3c8480c9d479f877314732 (patch) | |
tree | 71f1078d6cc71b2a4f1c129e06cf6d0d78830dfe /gir | |
parent | 6838e9313ad70781ac1316a05babbbf724ecfccc (diff) | |
download | gobject-introspection-96973b649ec973e8df3c8480c9d479f877314732.tar.gz |
Update glib annotations from git master
Diffstat (limited to 'gir')
-rw-r--r-- | gir/gio-2.0.c | 55 | ||||
-rw-r--r-- | gir/glib-2.0.c | 19 |
2 files changed, 68 insertions, 6 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index f9453632..25c437d8 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -185,6 +185,16 @@ /** + * GAppInfoMonitor: + * + * The only thing you can do with this is to get it via + * g_app_info_monitor_get() and connect to the "changed" signal. + * + * Since: 2.40 + */ + + +/** * GApplication::activate: * @application: the application * @@ -3663,6 +3673,7 @@ * SECTION:gappinfo * @short_description: Application information and launch contexts * @include: gio/gio.h + * @see_also: #GAppInfoMonitor * * #GAppInfo and #GAppLaunchContext are used for describing and launching * applications installed on the system. @@ -3718,6 +3729,32 @@ /** + * SECTION:gappinfomonitor + * @short_description: Monitor application information for changes + * + * #GAppInfoMonitor is a very simple object used for monitoring the app + * info database for changes (ie: newly installed or removed + * applications). + * + * Call g_app_info_monitor_get() to get a #GAppInfoMonitor and connect + * to the "changed" signal. + * + * In the usual case, applications should try to make note of the change + * (doing things like invalidating caches) but not act on it. In + * particular, applications should avoid making calls to #GAppInfo APIs + * in response to the change signal, deferring these until the time that + * the data is actually required. The exception to this case is when + * application information is actually being displayed on the screen + * (eg: during a search or when the list of all applications is shown). + * The reason for this is that changes to the list of installed + * applications often come in groups (like during system updates) and + * rescanning the list on every change is pointless and expensive. + * + * Since: 2.40 + */ + + +/** * SECTION:gapplication * @title: GApplication * @short_description: Core application class @@ -10843,6 +10880,24 @@ /** + * g_app_info_monitor_get: + * + * Gets the #GAppInfoMonitor for the current thread-default main + * context. + * + * The #GAppInfoMonitor will emit a "changed" signal in the + * thread-default main context whenever the list of installed + * applications (as reported by g_app_info_get_all()) may have changed. + * + * You must only call g_object_unref() on the return value from under + * the same main context as you created it. + * + * Returns: (transfer full): a reference to a #GAppInfoMonitor + * Since: 2.40 + */ + + +/** * g_app_info_remove_supports_type: * @appinfo: a #GAppInfo. * @content_type: a string. diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index f0af98da..69981bdf 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -12982,7 +12982,7 @@ * @days: the number of days * * Creates a copy of @datetime and adds the specified number of days to the - * copy. + * copy. Add negative values to subtract days. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -13001,7 +13001,7 @@ * @seconds: the number of seconds to add * * Creates a new #GDateTime adding the specified values to the current date and - * time in @datetime. + * time in @datetime. Add negative values to subtract. * * Returns: the newly created #GDateTime that should be freed with * g_date_time_unref(). @@ -13014,7 +13014,8 @@ * @datetime: a #GDateTime * @hours: the number of hours to add * - * Creates a copy of @datetime and adds the specified number of hours + * Creates a copy of @datetime and adds the specified number of hours. + * Add negative values to subtract hours. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -13028,6 +13029,7 @@ * @minutes: the number of minutes to add * * Creates a copy of @datetime adding the specified number of minutes. + * Add negative values to subtract minutes. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -13041,7 +13043,7 @@ * @months: the number of months * * Creates a copy of @datetime and adds the specified number of months to the - * copy. + * copy. Add negative values to subtract months. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -13055,6 +13057,7 @@ * @seconds: the number of seconds to add * * Creates a copy of @datetime and adds the specified number of seconds. + * Add negative values to subtract seconds. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -13068,7 +13071,7 @@ * @weeks: the number of weeks * * Creates a copy of @datetime and adds the specified number of weeks to the - * copy. + * copy. Add negative values to subtract weeks. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -13082,7 +13085,7 @@ * @years: the number of years * * Creates a copy of @datetime and adds the specified number of years to the - * copy. + * copy. Add negative values to subtract years. * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). @@ -22309,6 +22312,10 @@ * * Returns the pointer at the given index of the pointer array. * + * <note><para> + * This does not perform bounds checking on the given @index_, so you are + * responsible for checking it against the array length.</para></note> + * * Returns: the pointer at the given index. */ |