Update glib annotations from git master

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.
  */