gsocket: Document FD ownership with g_socket_new_from_fd()

https://bugzilla.gnome.org/show_bug.cgi?id=730188

diff --git a/gio/gsocket.c b/gio/gsocket.c
index 06c7235..7278e80 100644 (file)
--- 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().
  *