[PATCH v4 7/9] wispr: Document 'wispr_portal_web_result_success'.
Grant Erickson <[email protected]> Mon, 24 Mar 2025 21:59:25 -0700
| Newsgroups | dev.linux.lists.connman |
|---|---|
| Message-ID | <09fd61603e4b40bf2c6a5e1202b90670398d34a9.1742878567.git.gerickson@nuovations.com> |
Add documentation to the 'wispr_portal_web_result_success' function.
---
src/wispr.c | 23 +++++++++++++++++++++--
1 file changed, 21 insertions(+), 2 deletions(-)
diff --git a/src/wispr.c b/src/wispr.c
index 76a7ba219921..e69e90551979 100644
--- a/src/wispr.c
+++ b/src/wispr.c
@@ -658,7 +658,7 @@ static void wispr_portal_error(struct connman_wispr_portal_context *wp_context)
*
* @sa portal_manage_success_status
* @sa wispr_portal_web_result_failure
- * @sa wispr_portal_web_result_err
+ * @sa wispr_portal_web_result_success
* @sa wispr_portal_web_result
*
* @private
@@ -1024,7 +1024,7 @@ static bool wispr_manage_message(GWebResult *result,
* finalizing.
*
* @sa wispr_portal_web_result
- * @sa wispr_portal_web_result_no_err
+ * @sa wispr_portal_web_result_success
*
* @private
*
@@ -1039,6 +1039,25 @@ static void wispr_portal_web_result_failure(const GError *error,
wp_context->request_id = 0;
}
+/**
+ * @brief
+ * Handle closure and finalization of a web request associated with
+ * a successful "online" HTTP-based Internet reachability check.
+ *
+ * @param[in] result A pointer to the mutable web request
+ * result being finalized.
+ * @param[in,out] wp_context A pointer to the mutable WISPr portal
+ * detection context associated with the
+ * successful "online" HTTP-based
+ * Internet reachability check this is
+ * finalizing.
+ *
+ * @sa wispr_portal_web_result
+ * @sa wispr_portal_web_result_failure
+ *
+ * @private
+ *
+ */
static void wispr_portal_web_result_success(GWebResult *result,
struct connman_wispr_portal_context *wp_context)
{
--
2.45.0