docs: Move the GSocketConnection SECTION

Move it to the struct docs.

Signed-off-by: Philip Withnall <philip@tecnocode.co.uk>

Helps: #3037
This commit is contained in:
Philip Withnall
2023-10-24 10:58:28 +01:00
parent 43b4e7e097
commit 051c5336d4

View File

@@ -40,27 +40,24 @@
/** /**
* SECTION:gsocketconnection * GSocketConnection:
* @short_description: A socket connection
* @include: gio/gio.h
* @see_also: #GIOStream, #GSocketClient, #GSocketListener
* *
* #GSocketConnection is a #GIOStream for a connected socket. They * `GSocketConnection` is a [class@Gio.IOStream] for a connected socket. They
* can be created either by #GSocketClient when connecting to a host, * can be created either by [class@Gio.SocketClient] when connecting to a host,
* or by #GSocketListener when accepting a new client. * or by [class@Gio.SocketListener] when accepting a new client.
* *
* The type of the #GSocketConnection object returned from these calls * The type of the `GSocketConnection` object returned from these calls
* depends on the type of the underlying socket that is in use. For * depends on the type of the underlying socket that is in use. For
* instance, for a TCP/IP connection it will be a #GTcpConnection. * instance, for a TCP/IP connection it will be a [class@Gio.TcpConnection].
* *
* Choosing what type of object to construct is done with the socket * Choosing what type of object to construct is done with the socket
* connection factory, and it is possible for 3rd parties to register * connection factory, and it is possible for third parties to register
* custom socket connection types for specific combination of socket * custom socket connection types for specific combination of socket
* family/type/protocol using g_socket_connection_factory_register_type(). * family/type/protocol using [func@Gio.SocketConnection.factory_register_type].
* *
* To close a #GSocketConnection, use g_io_stream_close(). Closing both * To close a `GSocketConnection`, use [method@Gio.IOStream.close]. Closing both
* substreams of the #GIOStream separately will not close the underlying * substreams of the [class@Gio.IOStream] separately will not close the
* #GSocket. * underlying [class@Gio.Socket].
* *
* Since: 2.22 * Since: 2.22
*/ */