[PATCH v3 08/18] gweb: Add documentation to 'received_data'.

Grant Erickson <[email protected]> Thu, 20 Mar 2025 16:38:59 -0700
Newsgroups dev.linux.lists.connman
Message-ID <3a0aa0f1a0b48643f66a11c5b3e7fd3753b603d5.1742513884.git.gerickson@nuovations.com>
Add documentation to the 'received_data' function.
---
 gweb/gweb.c | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/gweb/gweb.c b/gweb/gweb.c
index c22ca8ef0aff..ad91d782e6e4 100644
--- a/gweb/gweb.c
+++ b/gweb/gweb.c
@@ -1227,6 +1227,28 @@ static bool received_data_continue(struct web_session *session,
 	return TRUE;
 }
 
+/**
+ *  @brief
+ *    Handle a glib I/O channel watch received data delegation for a
+ *    web session request.
+ *
+ *  This handles a glib I/O channel received data delegate for the web
+ *  session request associated with @a channel.
+ *
+ *  @param[in,out]  channel    A pointer to the glib channel that
+ *                             received data or a condition(s)/
+ *                             event(s).
+ *  @param[in]      cond       The conditions or events that
+ *                             generated this delegation.
+ *  @param[in,out]  user_data  A pointer to the mutable web session
+ *                             request associated with @a channel.
+ *
+ *  @sa received_data_finalize
+ *  @sa received_data_continue
+ *
+ *  @private
+ *
+ */
 static gboolean received_data(GIOChannel *channel, GIOCondition cond,
 							gpointer user_data)
 {
-- 
2.45.0