gsocket: Document FD ownership with g_socket_new_from_fd()
authorPhilip Withnall <philip.withnall@collabora.co.uk>
Thu, 15 May 2014 10:44:18 +0000 (11:44 +0100)
committerDan Winship <danw@gnome.org>
Sat, 21 Mar 2015 17:37:17 +0000 (13:37 -0400)
https://bugzilla.gnome.org/show_bug.cgi?id=730188

gio/gsocket.c

index 06c7235..7278e80 100644 (file)
@@ -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().
  *