[glib] gsocket: Document FD ownership with g_socket_new_from_fd()

[Dan Winship <danw src gnome org>]

commit 1b22df78221c829f89d0955eac970d73790dae4a
Author: Philip Withnall <philip withnall collabora co uk>
Date:   Thu May 15 11:44:18 2014 +0100

    gsocket: Document FD ownership with g_socket_new_from_fd()
    
    https://bugzilla.gnome.org/show_bug.cgi?id=730188

 gio/gsocket.c |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)
---
diff --git a/gio/gsocket.c b/gio/gsocket.c
index 06c7235..7278e80 100644
--- a/gio/gsocket.c
+++ b/gio/gsocket.c
@@ -1057,6 +1057,9 @@ g_socket_new (GSocketFamily     family,
  * will be set to non-blocking mode, independent on the blocking
  * mode of the #GSocket.
  *
+ * On success, the returned #GSocket takes ownership of @fd. On failure, the
+ * caller must close @fd themselves.
+ *
  * Returns: a #GSocket or %NULL on error.
  *     Free the returned object with g_object_unref().
  *