gsocketservice: Clarify g_socket_service_stop() documentation

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

diff --git a/gio/gsocketservice.c b/gio/gsocketservice.c
index 0ee0ad0..0b72e97 100644 (file)
--- a/gio/gsocketservice.c
+++ b/gio/gsocketservice.c
@@ -203,6 +203,12 @@ g_socket_service_start (GSocketService *service)
  * This call is thread-safe, so it may be called from a thread
  * handling an incoming client request.
  *
+ * Note that this only stops accepting new connections; it does not
+ * close the listening sockets, and you can call
+ * g_socket_service_start() again later to begin listening again. To
+ * close the listening sockets, call g_socket_listener_close(). (This
+ * will happen automatically when the #GSocketService is finalized.)
+ *
  * Since: 2.22
  */
 void