[glib] GDBusMethodInvocation: document behaviour change

[Allison Ryan Lortie <desrt src gnome org>]

commit 86c5d8978d75f88aaa14ab8ed6186212abcb8f19
Author: Allison Ryan Lortie <desrt desrt ca>
Date:   Wed Jan 13 10:50:46 2016 -0500

    GDBusMethodInvocation: document behaviour change
    
    We changed the behaviour of this API to adapt to a change in the D-Bus
    specification.  Document the new behaviour, along with the time of the
    change.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=755421

 gio/gdbusmethodinvocation.c |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/gio/gdbusmethodinvocation.c b/gio/gdbusmethodinvocation.c
index 85e8811..fc8bee2 100644
--- a/gio/gdbusmethodinvocation.c
+++ b/gio/gdbusmethodinvocation.c
@@ -538,6 +538,11 @@ g_dbus_method_invocation_return_value_internal (GDBusMethodInvocation *invocatio
  *
  * This method will free @invocation, you cannot use it afterwards.
  *
+ * Since 2.48, if the method call requested for a reply not to be sent
+ * then this call will sink @parameters and free @invocation, but
+ * otherwise do nothing (as per the recommendations of the D-Bus
+ * specification).
+ *
  * Since: 2.26
  */
 void
@@ -596,6 +601,10 @@ g_dbus_method_invocation_return_value_with_unix_fd_list (GDBusMethodInvocation *
  *
  * This method will free @invocation, you cannot use it afterwards.
  *
+ * Since 2.48, if the method call requested for a reply not to be sent
+ * then this call will free @invocation but otherwise do nothing (as per
+ * the recommendations of the D-Bus specification).
+ *
  * Since: 2.26
  */
 void