gnunet

commit 20bd667f1d4f60730118dfc0cd56f3f9fad49330
parent 98594a4d88fe911b57505e94ab3a1a9a6219ea0e
Author: Willow Liquorice <willow@howhill.com>
Date:   Wed,  7 Sep 2022 23:03:03 +0100

-DOC: Documentation cleanup pass through CONSENSUS subsystem

Diffstat:
M
src/consensus/plugin_block_consensus.c
 | 
1
-
M
src/include/gnunet_my_lib.h
 | 
4
++--
M
src/my/my_query_helper.c
 | 
14
+++++++-------
M
src/my/my_result_helper.c
 | 
7
-------
M
src/mysql/mysql.c
 | 
1
-

5 files changed, 9 insertions(+), 18 deletions(-)
diff --git a/src/consensus/plugin_block_consensus.c b/src/consensus/plugin_block_consensus.c
@@ -52,7 +52,6 @@ struct BlockContext
  * Function called to validate a query.
  *
  * @param cls closure
- * @param ctx block context
  * @param type block type
  * @param query original query (hash)
  * @param xquery extrended query data (can be NULL, depending on type)
diff --git a/src/include/gnunet_my_lib.h b/src/include/gnunet_my_lib.h
@@ -367,8 +367,8 @@ GNUNET_MY_query_param_uint64 (const uint64_t *x);
  * Variable-size result expected
  *
  * @param[out] dst where to store the result, allocated
- * @param[out] sptr where to store the size of @a dst
- * @return array entru for the result specification to use
+ * @param[out] ptr_size where to store the size of @a dst
+ * @return array entry for the result specification to use
  */
 struct GNUNET_MY_ResultSpec
 GNUNET_MY_result_spec_variable_size (void **dst,
diff --git a/src/my/my_query_helper.c b/src/my/my_query_helper.c
@@ -48,7 +48,7 @@ my_clean_query (void *cls,
  * Function called to convert input argument into SQL parameters.
  *
  * @param cls closure
- * @param pq data about the query
+ * @param qp data about the query
  * @param qbind array of parameters to initialize
  * @return -1 on error
  */
@@ -95,7 +95,7 @@ GNUNET_MY_query_param_fixed_size (const void *ptr,
  * Function called to convert input argument into SQL parameters.
  *
  * @param cls closure
- * @param pq data about the query
+ * @param qp data about the query
  * @param qbind array of parameters to initialize
  * @return -1 on error
  */
@@ -138,7 +138,7 @@ GNUNET_MY_query_param_string (const char *ptr)
  * Function called to convert input argument into SQL parameters
  *
  * @param cls closure
- * @param pq data about the query
+ * @param qp data about the query
  * @param qbind array of parameters to initialize
  * @return -1 on error
  */
@@ -182,7 +182,7 @@ GNUNET_MY_query_param_uint16 (const uint16_t *x)
  * Function called to convert input argument into SQL parameters
  *
  * @param cls closure
- * @param pq data about the query
+ * @param qp data about the query
  * @param qbind array of parameters to initialize
  * @return -1 on error
  */
@@ -226,7 +226,7 @@ GNUNET_MY_query_param_uint32 (const uint32_t *x)
  * Function called to convert input argument into SQL parameters
  *
  * @param cls closure
- * @param pq data about the query
+ * @param qp data about the query
  * @param qbind array of parameters to initialize
  * @return -1 on error
  */
@@ -270,7 +270,7 @@ GNUNET_MY_query_param_uint64 (const uint64_t *x)
  * Function called to convert input argument into SQL parameters
  *
  * @param cls closure
- * @param pq data about the query
+ * @param qp data about the query
  * @param qbind array of parameters to initialize
  * @return -1 on error
  */
@@ -322,7 +322,7 @@ GNUNET_MY_query_param_rsa_public_key (const struct
  * Function called to convert input argument into SQL parameters
  *
  *@param cls closure
- *@param pq data about the query
+ *@param qp data about the query
  *@param qbind array of parameters to initialize
  *@return -1 on error
  */
diff --git a/src/my/my_result_helper.c b/src/my/my_result_helper.c
@@ -129,13 +129,6 @@ cleanup_varsize_blob (void *cls,
 }
 
 
-/**
- * Variable-size result expected
- *
- * @param[out] dst where to store the result, allocated
- * @param[out] ptr_size where to store the size of @a dst
- * @return array entru for the result specification to use
- */
 struct GNUNET_MY_ResultSpec
 GNUNET_MY_result_spec_variable_size (void **dst,
                                      size_t *ptr_size)
diff --git a/src/mysql/mysql.c b/src/mysql/mysql.c
@@ -430,7 +430,6 @@ GNUNET_MYSQL_statement_run (struct GNUNET_MYSQL_Context *mc, const char *sql)
 /**
  * Prepare a statement for running.
  *
- * @param mc mysql context
  * @param sh statement handle to prepare
  * @return #GNUNET_OK on success
  */