[libsoup] soup-server: mark client context getters as nullable

[Marc-Andre Lureau <malureau src gnome org>]

commit 01b4164a0a9fea88c12d93baa2dd04cb6e7bbf83
Author: Marc-André Lureau <marcandre lureau gmail com>
Date:   Wed Feb 18 17:23:09 2015 +0100

    soup-server: mark client context getters as nullable
    
    Client should be aware that those functions could return NULL with
    hand-made SoupSocket clients.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=744186

 libsoup/soup-server.c |   24 ++++++++++++++----------
 1 files changed, 14 insertions(+), 10 deletions(-)
---
diff --git a/libsoup/soup-server.c b/libsoup/soup-server.c
index 70a46b8..b88e485 100644
--- a/libsoup/soup-server.c
+++ b/libsoup/soup-server.c
@@ -2095,8 +2095,8 @@ soup_client_context_get_socket (SoupClientContext *client)
  * not get fooled when the allocator reuses the memory address of a
  * previously-destroyed socket to represent a new socket.
  *
- * Return value: (transfer none): the #GSocket that @client is
- * associated with.
+ * Return value: (nullable) (transfer none): the #GSocket that @client is
+ * associated with, %NULL if you used soup_server_accept_iostream().
  *
  * Since: 2.48
  **/
@@ -2115,8 +2115,9 @@ soup_client_context_get_gsocket (SoupClientContext *client)
  * Retrieves the #SoupAddress associated with the remote end
  * of a connection.
  *
- * Return value: (transfer none): the #SoupAddress associated with the
- * remote end of a connection.
+ * Return value: (nullable) (transfer none): the #SoupAddress
+ * associated with the remote end of a connection, it may be
+ * %NULL if you used soup_server_accept_iostream().
  *
  * Deprecated: Use soup_client_context_get_remote_address(), which returns
  * a #GSocketAddress.
@@ -2136,8 +2137,9 @@ soup_client_context_get_address (SoupClientContext *client)
  * Retrieves the #GSocketAddress associated with the remote end
  * of a connection.
  *
- * Return value: (transfer none): the #GSocketAddress associated with
- * the remote end of a connection.
+ * Return value: (nullable) (transfer none): the #GSocketAddress
+ * associated with the remote end of a connection, it may be
+ * %NULL if you used soup_server_accept_iostream().
  *
  * Since: 2.48
  **/
@@ -2158,8 +2160,9 @@ soup_client_context_get_remote_address (SoupClientContext *client)
  * Retrieves the #GSocketAddress associated with the local end
  * of a connection.
  *
- * Return value: (transfer none): the #GSocketAddress associated with
- * the local end of a connection.
+ * Return value: (nullable) (transfer none): the #GSocketAddress
+ * associated with the local end of a connection, it may be
+ * %NULL if you used soup_server_accept_iostream().
  *
  * Since: 2.48
  **/
@@ -2180,8 +2183,9 @@ soup_client_context_get_local_address (SoupClientContext *client)
  * Retrieves the IP address associated with the remote end of a
  * connection.
  *
- * Return value: the IP address associated with the remote end of a
- * connection.
+ * Return value: (nullable): the IP address associated with the remote
+ * end of a connection, it may be %NULL if you used
+ * soup_server_accept_iostream().
  **/
 const char *
 soup_client_context_get_host (SoupClientContext *client)