[glib] gsignal: Mark the return value of g_signal_emitv() as (inout) (optional)

[Philip Withnall <pwithnall src gnome org>]

commit 073a81d1da69689c3228846c81e93de2a4931ff4
Author: Philip Withnall <philip withnall collabora co uk>
Date:   Mon Jun 30 15:57:28 2014 +0100

    gsignal: Mark the return value of g_signal_emitv() as (inout) (optional)
    
    https://bugzilla.gnome.org/show_bug.cgi?id=719966

 gobject/gsignal.c |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/gobject/gsignal.c b/gobject/gsignal.c
index e02a700..aab35a1 100644
--- a/gobject/gsignal.c
+++ b/gobject/gsignal.c
@@ -2940,7 +2940,9 @@ g_signal_has_handler_pending (gpointer instance,
  *  is being emitted on. The rest are any arguments to be passed to the signal.
  * @signal_id: the signal id
  * @detail: the detail
- * @return_value: Location to store the return value of the signal emission.
+ * @return_value: (inout) (optional): Location to
+ * store the return value of the signal emission. This must be provided if the
+ * specified signal returns a value, but may be ignored otherwise.
  *
  * Emits a signal.
  *