Move clarification to a separate note
Signed-off-by: David Horstmann <david.horstmann@arm.com>
diff --git a/include/mbedtls/net_sockets.h b/include/mbedtls/net_sockets.h
index 7a0148b..6bcd920 100644
--- a/include/mbedtls/net_sockets.h
+++ b/include/mbedtls/net_sockets.h
@@ -280,16 +280,24 @@
uint32_t timeout);
/**
- * \brief Close down the connection and clear the context
+ * \brief Closes down the connection and free associated data
*
* \param ctx The context to close
+ *
+ * \note This function frees and clears data associated with the
+ * context but does not free the memory pointed to by \p ctx.
+ * This memory is the responsibility of the caller.
*/
void mbedtls_net_close(mbedtls_net_context *ctx);
/**
- * \brief Gracefully shutdown the connection and clear the context
+ * \brief Gracefully shutdown the connection and free associated data
*
- * \param ctx The context to gracefully shutdown
+ * \param ctx The context to free
+ *
+ * \note This function frees and clears data associated with the
+ * context but does not free the memory pointed to by \p ctx.
+ * This memory is the responsibility of the caller.
*/
void mbedtls_net_free(mbedtls_net_context *ctx);