diff options
author | Willow Liquorice <willow@howhill.com> | 2022-09-02 22:45:52 +0100 |
---|---|---|
committer | Willow Liquorice <willow@howhill.com> | 2022-10-03 00:44:29 +0100 |
commit | d4f25caabd6098a2cbb713c9cd8228c1f9a26fe4 (patch) | |
tree | fd9e4747415780951809ae3c1ff7330a32853923 /src | |
parent | e13e66d0dc6a79f6dfe469ba075f307c006fdb66 (diff) | |
download | gnunet-d4f25caabd6098a2cbb713c9cd8228c1f9a26fe4.tar.gz gnunet-d4f25caabd6098a2cbb713c9cd8228c1f9a26fe4.zip |
-DOC: Minor fixes to doc comments (mostly correcting typos) to resolve 'unknown command' warnings
Diffstat (limited to 'src')
27 files changed, 48 insertions, 48 deletions
diff --git a/src/block/bg_bf.c b/src/block/bg_bf.c index b79ea3c55..c8269498e 100644 --- a/src/block/bg_bf.c +++ b/src/block/bg_bf.c | |||
@@ -226,7 +226,7 @@ GNUNET_BLOCK_GROUP_bf_create (void *cls, | |||
226 | * @param bg block group to use for testing | 226 | * @param bg block group to use for testing |
227 | * @param hc hash of element to evaluate | 227 | * @param hc hash of element to evaluate |
228 | * @return #GNUNET_YES if @a hc is (likely) a duplicate | 228 | * @return #GNUNET_YES if @a hc is (likely) a duplicate |
229 | * #GNUNET_NO if @a hc was definitively not in @bg (but now is) | 229 | * #GNUNET_NO if @a hc was definitively not in @a bg (but now is) |
230 | */ | 230 | */ |
231 | enum GNUNET_GenericReturnValue | 231 | enum GNUNET_GenericReturnValue |
232 | GNUNET_BLOCK_GROUP_bf_test_and_set (struct GNUNET_BLOCK_Group *bg, | 232 | GNUNET_BLOCK_GROUP_bf_test_and_set (struct GNUNET_BLOCK_Group *bg, |
diff --git a/src/cadet/gnunet-service-cadet_channel.c b/src/cadet/gnunet-service-cadet_channel.c index f742ba4a7..78658c296 100644 --- a/src/cadet/gnunet-service-cadet_channel.c +++ b/src/cadet/gnunet-service-cadet_channel.c | |||
@@ -1157,7 +1157,7 @@ GCCH_handle_channel_open_ack ( | |||
1157 | * @param cls closure, to a flag where we indicate duplicate packets | 1157 | * @param cls closure, to a flag where we indicate duplicate packets |
1158 | * @param m1 a message of to sort | 1158 | * @param m1 a message of to sort |
1159 | * @param m2 another message to sort | 1159 | * @param m2 another message to sort |
1160 | * @return #GNUNET_YES if @e1 < @e2, otherwise #GNUNET_NO | 1160 | * @return #GNUNET_YES if @a e1 < @a e2, otherwise #GNUNET_NO |
1161 | */ | 1161 | */ |
1162 | static int | 1162 | static int |
1163 | is_before (void *cls, | 1163 | is_before (void *cls, |
@@ -1645,7 +1645,7 @@ GCCH_handle_remote_destroy ( | |||
1645 | * @param cls closure, to a flag where we indicate duplicate packets | 1645 | * @param cls closure, to a flag where we indicate duplicate packets |
1646 | * @param crm1 an element of to sort | 1646 | * @param crm1 an element of to sort |
1647 | * @param crm2 another element to sort | 1647 | * @param crm2 another element to sort |
1648 | * @return #GNUNET_YES if @e1 < @e2, otherwise #GNUNET_NO | 1648 | * @return #GNUNET_YES if @a e1 < @a e2, otherwise #GNUNET_NO |
1649 | */ | 1649 | */ |
1650 | static int | 1650 | static int |
1651 | cmp_crm_by_next_retry (void *cls, | 1651 | cmp_crm_by_next_retry (void *cls, |
diff --git a/src/cadet/gnunet-service-cadet_peer.c b/src/cadet/gnunet-service-cadet_peer.c index 99669eb05..3fb0eed94 100644 --- a/src/cadet/gnunet-service-cadet_peer.c +++ b/src/cadet/gnunet-service-cadet_peer.c | |||
@@ -211,7 +211,7 @@ struct CadetPeer | |||
211 | 211 | ||
212 | /** | 212 | /** |
213 | * Sum over all of the offsets of all of the paths in the @a path_heads DLLs. | 213 | * Sum over all of the offsets of all of the paths in the @a path_heads DLLs. |
214 | * Used to speed-up @GCP_get_desirability_of_path() calculation. | 214 | * Used to speed-up #GCP_get_desirability_of_path() calculation. |
215 | */ | 215 | */ |
216 | unsigned int off_sum; | 216 | unsigned int off_sum; |
217 | 217 | ||
@@ -225,7 +225,7 @@ struct CadetPeer | |||
225 | unsigned int mqm_ready_counter; | 225 | unsigned int mqm_ready_counter; |
226 | 226 | ||
227 | /** | 227 | /** |
228 | * Current length of the @e path_heads and @path_tails arrays. | 228 | * Current length of the @e path_heads and @e path_tails arrays. |
229 | * The arrays should be grown as needed. | 229 | * The arrays should be grown as needed. |
230 | */ | 230 | */ |
231 | unsigned int path_dll_length; | 231 | unsigned int path_dll_length; |
diff --git a/src/cadet/gnunet-service-cadet_tunnels.c b/src/cadet/gnunet-service-cadet_tunnels.c index 9653fd3ec..ca91a0e01 100644 --- a/src/cadet/gnunet-service-cadet_tunnels.c +++ b/src/cadet/gnunet-service-cadet_tunnels.c | |||
@@ -169,7 +169,7 @@ struct CadetTunnelAxolotl | |||
169 | * 32-byte chain keys (used for forward-secrecy) for | 169 | * 32-byte chain keys (used for forward-secrecy) for |
170 | * receiving messages. Updated for every message. If | 170 | * receiving messages. Updated for every message. If |
171 | * messages are skipped, the respective derived MKs | 171 | * messages are skipped, the respective derived MKs |
172 | * (and the current @HKr) are kept in the @e skipped_head DLL. | 172 | * (and the current @e HKr) are kept in the @e skipped_head DLL. |
173 | */ | 173 | */ |
174 | struct GNUNET_CRYPTO_SymmetricSessionKey CKr; | 174 | struct GNUNET_CRYPTO_SymmetricSessionKey CKr; |
175 | 175 | ||
diff --git a/src/dht/gnunet-service-dht_neighbours.h b/src/dht/gnunet-service-dht_neighbours.h index 96db21b9b..2aa304242 100644 --- a/src/dht/gnunet-service-dht_neighbours.h +++ b/src/dht/gnunet-service-dht_neighbours.h | |||
@@ -150,7 +150,7 @@ GDS_try_connect (void *cls, | |||
150 | * @param cls the closure, must be a `struct GDS_Underlay` | 150 | * @param cls the closure, must be a `struct GDS_Underlay` |
151 | * @param target handle to the target, | 151 | * @param target handle to the target, |
152 | * pointer will remain valid until @e disconnect_cb is called | 152 | * pointer will remain valid until @e disconnect_cb is called |
153 | * @para pid peer identity, | 153 | * @param pid peer identity, |
154 | * pointer will remain valid until @e disconnect_cb is called | 154 | * pointer will remain valid until @e disconnect_cb is called |
155 | * @param[out] ctx storage space for DHT to use in association with this target | 155 | * @param[out] ctx storage space for DHT to use in association with this target |
156 | */ | 156 | */ |
diff --git a/src/include/gnunet_ats_service.h b/src/include/gnunet_ats_service.h index 11a65c4f5..60154d04d 100644 --- a/src/include/gnunet_ats_service.h +++ b/src/include/gnunet_ats_service.h | |||
@@ -344,7 +344,7 @@ GNUNET_ATS_address_add_session (struct GNUNET_ATS_AddressRecord *ar, | |||
344 | * @param session session handle | 344 | * @param session session handle |
345 | * @return #GNUNET_YES if the @a ar was destroyed because | 345 | * @return #GNUNET_YES if the @a ar was destroyed because |
346 | * it was an incoming address, | 346 | * it was an incoming address, |
347 | * #GNUNET_NO if the @ar was kept because we can | 347 | * #GNUNET_NO if the @a ar was kept because we can |
348 | * use it still to establish a new session | 348 | * use it still to establish a new session |
349 | */ | 349 | */ |
350 | int | 350 | int |
diff --git a/src/include/gnunet_block_group_lib.h b/src/include/gnunet_block_group_lib.h index d242ceefb..53827f5f4 100644 --- a/src/include/gnunet_block_group_lib.h +++ b/src/include/gnunet_block_group_lib.h | |||
@@ -90,7 +90,7 @@ GNUNET_BLOCK_GROUP_bf_create (void *cls, | |||
90 | * @param bg block group to use for testing | 90 | * @param bg block group to use for testing |
91 | * @param hc hash of element to evaluate | 91 | * @param hc hash of element to evaluate |
92 | * @return #GNUNET_YES if @a hc is (likely) a duplicate | 92 | * @return #GNUNET_YES if @a hc is (likely) a duplicate |
93 | * #GNUNET_NO if @a hc was definitively not in @bg (but now is) | 93 | * #GNUNET_NO if @a hc was definitively not in @a bg (but now is) |
94 | */ | 94 | */ |
95 | enum GNUNET_GenericReturnValue | 95 | enum GNUNET_GenericReturnValue |
96 | GNUNET_BLOCK_GROUP_bf_test_and_set (struct GNUNET_BLOCK_Group *bg, | 96 | GNUNET_BLOCK_GROUP_bf_test_and_set (struct GNUNET_BLOCK_Group *bg, |
diff --git a/src/include/gnunet_block_lib.h b/src/include/gnunet_block_lib.h index fe6c99613..a9a5ec8af 100644 --- a/src/include/gnunet_block_lib.h +++ b/src/include/gnunet_block_lib.h | |||
@@ -272,7 +272,7 @@ GNUNET_BLOCK_group_set_seen (struct GNUNET_BLOCK_Group *bg, | |||
272 | 272 | ||
273 | /** | 273 | /** |
274 | * Try merging two block groups. Afterwards, @a bg1 should remain | 274 | * Try merging two block groups. Afterwards, @a bg1 should remain |
275 | * valid and contain the rules from both @a bg1 and @bg2, and | 275 | * valid and contain the rules from both @a bg1 and @a bg2, and |
276 | * @a bg2 should be destroyed (as part of this call). The latter | 276 | * @a bg2 should be destroyed (as part of this call). The latter |
277 | * should happen even if merging is not supported. | 277 | * should happen even if merging is not supported. |
278 | * | 278 | * |
diff --git a/src/include/gnunet_configuration_lib.h b/src/include/gnunet_configuration_lib.h index ac0013e94..2d26f3c05 100644 --- a/src/include/gnunet_configuration_lib.h +++ b/src/include/gnunet_configuration_lib.h | |||
@@ -174,7 +174,7 @@ GNUNET_CONFIGURATION_serialize_diagnostics ( | |||
174 | * @param mem the memory block of serialized configuration | 174 | * @param mem the memory block of serialized configuration |
175 | * @param size the size of the memory block | 175 | * @param size the size of the memory block |
176 | * @param source_filename source filename, will be used | 176 | * @param source_filename source filename, will be used |
177 | * to resolve relative @INLINE@ statements | 177 | * to resolve relative \@INLINE\@ statements |
178 | * @return #GNUNET_OK on success, #GNUNET_SYSERR on error | 178 | * @return #GNUNET_OK on success, #GNUNET_SYSERR on error |
179 | */ | 179 | */ |
180 | enum GNUNET_GenericReturnValue | 180 | enum GNUNET_GenericReturnValue |
diff --git a/src/include/gnunet_crypto_lib.h b/src/include/gnunet_crypto_lib.h index 7ff50dda1..cb0b0d9a3 100644 --- a/src/include/gnunet_crypto_lib.h +++ b/src/include/gnunet_crypto_lib.h | |||
@@ -2432,7 +2432,7 @@ GNUNET_CRYPTO_paillier_encrypt ( | |||
2432 | * @param private_key Private key to use for decryption. | 2432 | * @param private_key Private key to use for decryption. |
2433 | * @param public_key Public key to use for decryption. | 2433 | * @param public_key Public key to use for decryption. |
2434 | * @param ciphertext Ciphertext to decrypt. | 2434 | * @param ciphertext Ciphertext to decrypt. |
2435 | * @param[out] m Decryption of @a ciphertext with @private_key. | 2435 | * @param[out] m Decryption of @a ciphertext with @a private_key. |
2436 | */ | 2436 | */ |
2437 | void | 2437 | void |
2438 | GNUNET_CRYPTO_paillier_decrypt ( | 2438 | GNUNET_CRYPTO_paillier_decrypt ( |
diff --git a/src/include/gnunet_curl_lib.h b/src/include/gnunet_curl_lib.h index b5d62ba0f..fdd05600c 100644 --- a/src/include/gnunet_curl_lib.h +++ b/src/include/gnunet_curl_lib.h | |||
@@ -224,7 +224,7 @@ typedef void | |||
224 | * be executed AND cleaned up | 224 | * be executed AND cleaned up |
225 | * @param jcc callback to invoke upon completion | 225 | * @param jcc callback to invoke upon completion |
226 | * @param jcc_cls closure for @a jcc | 226 | * @param jcc_cls closure for @a jcc |
227 | * @return NULL on error (in this case, @eh is still released!) | 227 | * @return NULL on error (in this case, @a eh is still released!) |
228 | */ | 228 | */ |
229 | struct GNUNET_CURL_Job * | 229 | struct GNUNET_CURL_Job * |
230 | GNUNET_CURL_job_add (struct GNUNET_CURL_Context *ctx, | 230 | GNUNET_CURL_job_add (struct GNUNET_CURL_Context *ctx, |
@@ -246,7 +246,7 @@ GNUNET_CURL_job_add (struct GNUNET_CURL_Context *ctx, | |||
246 | * be executed AND cleaned up | 246 | * be executed AND cleaned up |
247 | * @param jcc callback to invoke upon completion | 247 | * @param jcc callback to invoke upon completion |
248 | * @param jcc_cls closure for @a jcc | 248 | * @param jcc_cls closure for @a jcc |
249 | * @return NULL on error (in this case, @eh is still released!) | 249 | * @return NULL on error (in this case, @a eh is still released!) |
250 | */ | 250 | */ |
251 | struct GNUNET_CURL_Job * | 251 | struct GNUNET_CURL_Job * |
252 | GNUNET_CURL_job_add_with_ct_json (struct GNUNET_CURL_Context *ctx, | 252 | GNUNET_CURL_job_add_with_ct_json (struct GNUNET_CURL_Context *ctx, |
@@ -304,7 +304,7 @@ GNUNET_CURL_set_tlscert (struct GNUNET_CURL_Context *ctx, | |||
304 | * @param job_headers extra headers to add for this request | 304 | * @param job_headers extra headers to add for this request |
305 | * @param jcc callback to invoke upon completion | 305 | * @param jcc callback to invoke upon completion |
306 | * @param jcc_cls closure for @a jcc | 306 | * @param jcc_cls closure for @a jcc |
307 | * @return NULL on error (in this case, @eh is still released!) | 307 | * @return NULL on error (in this case, @a eh is still released!) |
308 | */ | 308 | */ |
309 | struct GNUNET_CURL_Job * | 309 | struct GNUNET_CURL_Job * |
310 | GNUNET_CURL_job_add2 (struct GNUNET_CURL_Context *ctx, | 310 | GNUNET_CURL_job_add2 (struct GNUNET_CURL_Context *ctx, |
@@ -327,7 +327,7 @@ GNUNET_CURL_job_add2 (struct GNUNET_CURL_Context *ctx, | |||
327 | * @param max_reply_size largest acceptable response body | 327 | * @param max_reply_size largest acceptable response body |
328 | * @param jcc callback to invoke upon completion | 328 | * @param jcc callback to invoke upon completion |
329 | * @param jcc_cls closure for @a jcc | 329 | * @param jcc_cls closure for @a jcc |
330 | * @return NULL on error (in this case, @eh is still released!) | 330 | * @return NULL on error (in this case, @a eh is still released!) |
331 | */ | 331 | */ |
332 | struct GNUNET_CURL_Job * | 332 | struct GNUNET_CURL_Job * |
333 | GNUNET_CURL_job_add_raw (struct GNUNET_CURL_Context *ctx, | 333 | GNUNET_CURL_job_add_raw (struct GNUNET_CURL_Context *ctx, |
diff --git a/src/include/gnunet_dhtu_plugin.h b/src/include/gnunet_dhtu_plugin.h index fa0b5f667..81b0f1d7b 100644 --- a/src/include/gnunet_dhtu_plugin.h +++ b/src/include/gnunet_dhtu_plugin.h | |||
@@ -119,7 +119,7 @@ struct GNUNET_DHTU_PluginEnvironment | |||
119 | * @param cls the closure | 119 | * @param cls the closure |
120 | * @param target handle to the target, | 120 | * @param target handle to the target, |
121 | * pointer will remain valid until @e disconnect_cb is called | 121 | * pointer will remain valid until @e disconnect_cb is called |
122 | * @para pid peer identity, | 122 | * @param pid peer identity, |
123 | * pointer will remain valid until @e disconnect_cb is called | 123 | * pointer will remain valid until @e disconnect_cb is called |
124 | * @param[out] ctx storage space for DHT to use in association with this target | 124 | * @param[out] ctx storage space for DHT to use in association with this target |
125 | */ | 125 | */ |
diff --git a/src/include/gnunet_my_lib.h b/src/include/gnunet_my_lib.h index 0c95d50d0..74f8353e0 100644 --- a/src/include/gnunet_my_lib.h +++ b/src/include/gnunet_my_lib.h | |||
@@ -126,7 +126,7 @@ struct GNUNET_MY_QueryParam | |||
126 | * @a ptr_size bytes.FG | 126 | * @a ptr_size bytes.FG |
127 | * | 127 | * |
128 | * @param ptr pointer to the query parameter to pass | 128 | * @param ptr pointer to the query parameter to pass |
129 | * @oaran ptr_size number of bytes in @a ptr | 129 | * @param ptr_size number of bytes in @a ptr |
130 | */ | 130 | */ |
131 | struct GNUNET_MY_QueryParam | 131 | struct GNUNET_MY_QueryParam |
132 | GNUNET_MY_query_param_fixed_size (const void *ptr, | 132 | GNUNET_MY_query_param_fixed_size (const void *ptr, |
@@ -262,7 +262,7 @@ struct GNUNET_MY_ResultSpec | |||
262 | * MySQL, store in already allocated buffer at @a ptr. | 262 | * MySQL, store in already allocated buffer at @a ptr. |
263 | * | 263 | * |
264 | * @spec ptr where to write the result | 264 | * @spec ptr where to write the result |
265 | * @oaran ptr_size number of bytes available at @a ptr | 265 | * @param ptr_size number of bytes available at @a ptr |
266 | */ | 266 | */ |
267 | struct GNUNET_MY_ResultSpec | 267 | struct GNUNET_MY_ResultSpec |
268 | GNUNET_MY_result_spec_fixed_size (void *ptr, | 268 | GNUNET_MY_result_spec_fixed_size (void *ptr, |
@@ -271,7 +271,7 @@ GNUNET_MY_result_spec_fixed_size (void *ptr, | |||
271 | /** | 271 | /** |
272 | * Generate query parameter for a string | 272 | * Generate query parameter for a string |
273 | * | 273 | * |
274 | *@param ptr pointer to the string query parameter to pass | 274 | * @param ptr pointer to the string query parameter to pass |
275 | */ | 275 | */ |
276 | struct GNUNET_MY_QueryParam | 276 | struct GNUNET_MY_QueryParam |
277 | GNUNET_MY_query_param_string (const char *ptr); | 277 | GNUNET_MY_query_param_string (const char *ptr); |
@@ -339,7 +339,7 @@ GNUNET_MY_query_param_uint16 (const uint16_t *x); | |||
339 | /** | 339 | /** |
340 | * Generate query parameter for an uint32_t in host byte order | 340 | * Generate query parameter for an uint32_t in host byte order |
341 | * | 341 | * |
342 | *@param x pointer to the query parameter to pass | 342 | * @param x pointer to the query parameter to pass |
343 | */ | 343 | */ |
344 | struct GNUNET_MY_QueryParam | 344 | struct GNUNET_MY_QueryParam |
345 | GNUNET_MY_query_param_uint32 (const uint32_t *x); | 345 | GNUNET_MY_query_param_uint32 (const uint32_t *x); |
@@ -347,7 +347,7 @@ GNUNET_MY_query_param_uint32 (const uint32_t *x); | |||
347 | /** | 347 | /** |
348 | * Generate query parameter for an uint64_t in host byte order | 348 | * Generate query parameter for an uint64_t in host byte order |
349 | * | 349 | * |
350 | *@param x pointer to the query parameter to pass | 350 | * @param x pointer to the query parameter to pass |
351 | */ | 351 | */ |
352 | struct GNUNET_MY_QueryParam | 352 | struct GNUNET_MY_QueryParam |
353 | GNUNET_MY_query_param_uint64 (const uint64_t *x); | 353 | GNUNET_MY_query_param_uint64 (const uint64_t *x); |
diff --git a/src/include/gnunet_pq_lib.h b/src/include/gnunet_pq_lib.h index 2263704aa..c4fec0a10 100644 --- a/src/include/gnunet_pq_lib.h +++ b/src/include/gnunet_pq_lib.h | |||
@@ -118,7 +118,7 @@ GNUNET_PQ_query_param_null (void); | |||
118 | * @a ptr_size bytes. | 118 | * @a ptr_size bytes. |
119 | * | 119 | * |
120 | * @param ptr pointer to the query parameter to pass | 120 | * @param ptr pointer to the query parameter to pass |
121 | * @oaran ptr_size number of bytes in @a ptr | 121 | * @param ptr_size number of bytes in @a ptr |
122 | * @return query parameter to use | 122 | * @return query parameter to use |
123 | */ | 123 | */ |
124 | struct GNUNET_PQ_QueryParam | 124 | struct GNUNET_PQ_QueryParam |
@@ -895,14 +895,14 @@ enum GNUNET_PQ_Options | |||
895 | * configuration. Initialize logging via GNUnet's log routines and disable | 895 | * configuration. Initialize logging via GNUnet's log routines and disable |
896 | * Postgres's logger. Also ensures that the statements in @a load_path and @a | 896 | * Postgres's logger. Also ensures that the statements in @a load_path and @a |
897 | * es are executed whenever we (re)connect to the database, and that the | 897 | * es are executed whenever we (re)connect to the database, and that the |
898 | * prepared statements in @a ps are "ready". If statements in @es fail that | 898 | * prepared statements in @a ps are "ready". If statements in @a es fail that |
899 | * were created with #GNUNET_PQ_make_execute(), then the entire operation | 899 | * were created with #GNUNET_PQ_make_execute(), then the entire operation |
900 | * fails. | 900 | * fails. |
901 | * | 901 | * |
902 | * In @a load_path, a list of "$XXXX.sql" files is expected where $XXXX | 902 | * In @a load_path, a list of "$XXXX.sql" files is expected where $XXXX |
903 | * must be a sequence of contiguous integer values starting at 0000. | 903 | * must be a sequence of contiguous integer values starting at 0000. |
904 | * These files are then loaded in sequence using "psql $config_str" before | 904 | * These files are then loaded in sequence using "psql $config_str" before |
905 | * running statements from @e es. The directory is inspected again on | 905 | * running statements from @a es. The directory is inspected again on |
906 | * reconnect. | 906 | * reconnect. |
907 | * | 907 | * |
908 | * @param config_str configuration to use | 908 | * @param config_str configuration to use |
@@ -939,7 +939,7 @@ GNUNET_PQ_exec_sql (struct GNUNET_PQ_Context *db, | |||
939 | * configuration. Initialize logging via GNUnet's log routines and disable | 939 | * configuration. Initialize logging via GNUnet's log routines and disable |
940 | * Postgres's logger. Also ensures that the statements in @a load_path and @a | 940 | * Postgres's logger. Also ensures that the statements in @a load_path and @a |
941 | * es are executed whenever we (re)connect to the database, and that the | 941 | * es are executed whenever we (re)connect to the database, and that the |
942 | * prepared statements in @a ps are "ready". If statements in @es fail that | 942 | * prepared statements in @a ps are "ready". If statements in @a es fail that |
943 | * were created with #GNUNET_PQ_make_execute(), then the entire operation | 943 | * were created with #GNUNET_PQ_make_execute(), then the entire operation |
944 | * fails. | 944 | * fails. |
945 | * | 945 | * |
diff --git a/src/include/gnunet_sq_lib.h b/src/include/gnunet_sq_lib.h index 51713e755..3406b9031 100644 --- a/src/include/gnunet_sq_lib.h +++ b/src/include/gnunet_sq_lib.h | |||
@@ -91,7 +91,7 @@ struct GNUNET_SQ_QueryParam | |||
91 | * @a ptr_size bytes. | 91 | * @a ptr_size bytes. |
92 | * | 92 | * |
93 | * @param ptr pointer to the query parameter to pass | 93 | * @param ptr pointer to the query parameter to pass |
94 | * @oaran ptr_size number of bytes in @a ptr | 94 | * @param ptr_size number of bytes in @a ptr |
95 | */ | 95 | */ |
96 | struct GNUNET_SQ_QueryParam | 96 | struct GNUNET_SQ_QueryParam |
97 | GNUNET_SQ_query_param_fixed_size (const void *ptr, | 97 | GNUNET_SQ_query_param_fixed_size (const void *ptr, |
diff --git a/src/namestore/gnunet-namestore-fcfsd.c b/src/namestore/gnunet-namestore-fcfsd.c index 7e96ffa43..4a9c6e874 100644 --- a/src/namestore/gnunet-namestore-fcfsd.c +++ b/src/namestore/gnunet-namestore-fcfsd.c | |||
@@ -1137,7 +1137,7 @@ run_service (void *cls, | |||
1137 | * The main function of the fcfs daemon. | 1137 | * The main function of the fcfs daemon. |
1138 | * | 1138 | * |
1139 | * @param argc number of arguments from the command line | 1139 | * @param argc number of arguments from the command line |
1140 | * @parsm argv the command line arguments | 1140 | * @param argv the command line arguments |
1141 | * @return 0 successful exit, a different value otherwise | 1141 | * @return 0 successful exit, a different value otherwise |
1142 | */ | 1142 | */ |
1143 | int | 1143 | int |
diff --git a/src/nse/gnunet-service-nse.c b/src/nse/gnunet-service-nse.c index 56014752d..ee1cb025f 100644 --- a/src/nse/gnunet-service-nse.c +++ b/src/nse/gnunet-service-nse.c | |||
@@ -1199,7 +1199,7 @@ handle_core_connect (void *cls, | |||
1199 | * | 1199 | * |
1200 | * @param cls closure | 1200 | * @param cls closure |
1201 | * @param peer peer identity this notification is about | 1201 | * @param peer peer identity this notification is about |
1202 | * @parma internal_cls the `struct NSEPeerEntry` for the @a peer | 1202 | * @param internal_cls the `struct NSEPeerEntry` for the @a peer |
1203 | */ | 1203 | */ |
1204 | static void | 1204 | static void |
1205 | handle_core_disconnect (void *cls, | 1205 | handle_core_disconnect (void *cls, |
diff --git a/src/reclaim/gnunet-service-reclaim.c b/src/reclaim/gnunet-service-reclaim.c index 84a98d1e4..9f035f1bd 100644 --- a/src/reclaim/gnunet-service-reclaim.c +++ b/src/reclaim/gnunet-service-reclaim.c | |||
@@ -723,8 +723,8 @@ issue_ticket_result_cb (void *cls, | |||
723 | /** | 723 | /** |
724 | * Check issue ticket message | 724 | * Check issue ticket message |
725 | * | 725 | * |
726 | * @cls unused | 726 | * @param cls unused |
727 | * @im message to check | 727 | * @param im message to check |
728 | * @return GNUNET_OK if message is ok | 728 | * @return GNUNET_OK if message is ok |
729 | */ | 729 | */ |
730 | static int | 730 | static int |
@@ -937,7 +937,7 @@ check_consume_ticket_message (void *cls, const struct ConsumeTicketMessage *cm) | |||
937 | * Handle a consume ticket message | 937 | * Handle a consume ticket message |
938 | * | 938 | * |
939 | * @param cls our client handle | 939 | * @param cls our client handle |
940 | * @cm the message to handle | 940 | * @param cm the message to handle |
941 | */ | 941 | */ |
942 | static void | 942 | static void |
943 | handle_consume_ticket_message (void *cls, const struct ConsumeTicketMessage *cm) | 943 | handle_consume_ticket_message (void *cls, const struct ConsumeTicketMessage *cm) |
@@ -1686,8 +1686,8 @@ attr_delete_cont (void *cls, int32_t success, const char *emsg) | |||
1686 | /** | 1686 | /** |
1687 | * Check attribute delete message format | 1687 | * Check attribute delete message format |
1688 | * | 1688 | * |
1689 | * @cls unused | 1689 | * @param cls unused |
1690 | * @dam message to check | 1690 | * @param dam message to check |
1691 | */ | 1691 | */ |
1692 | static int | 1692 | static int |
1693 | check_attribute_delete_message (void *cls, | 1693 | check_attribute_delete_message (void *cls, |
@@ -1777,8 +1777,8 @@ cred_delete_cont (void *cls, int32_t success, const char *emsg) | |||
1777 | /** | 1777 | /** |
1778 | * Check credential delete message format | 1778 | * Check credential delete message format |
1779 | * | 1779 | * |
1780 | * @cls unused | 1780 | * @param cls unused |
1781 | * @dam message to check | 1781 | * @param dam message to check |
1782 | */ | 1782 | */ |
1783 | static int | 1783 | static int |
1784 | check_credential_delete_message (void *cls, | 1784 | check_credential_delete_message (void *cls, |
diff --git a/src/reclaim/gnunet-service-reclaim_tickets.c b/src/reclaim/gnunet-service-reclaim_tickets.c index 23b617a7f..c961ba5b2 100644 --- a/src/reclaim/gnunet-service-reclaim_tickets.c +++ b/src/reclaim/gnunet-service-reclaim_tickets.c | |||
@@ -1671,7 +1671,7 @@ cleanup_iter (struct RECLAIM_TICKETS_Iterator *iter) | |||
1671 | 1671 | ||
1672 | 1672 | ||
1673 | /** | 1673 | /** |
1674 | * Return each record of type @GNUNET_GNSRECORD_TYPE_RECLAIM_TICKET | 1674 | * Return each record of type #GNUNET_GNSRECORD_TYPE_RECLAIM_TICKET |
1675 | * to the caller and proceed with the iteration. | 1675 | * to the caller and proceed with the iteration. |
1676 | * FIXME: Should we _not_ proceed automatically here? | 1676 | * FIXME: Should we _not_ proceed automatically here? |
1677 | * | 1677 | * |
diff --git a/src/regex/gnunet-service-regex.c b/src/regex/gnunet-service-regex.c index deaa6112e..dc61b9135 100644 --- a/src/regex/gnunet-service-regex.c +++ b/src/regex/gnunet-service-regex.c | |||
@@ -124,7 +124,7 @@ reannounce (void *cls) | |||
124 | * | 124 | * |
125 | * @param cls identification of the client | 125 | * @param cls identification of the client |
126 | * @param am the actual message | 126 | * @param am the actual message |
127 | * @return #GNUNET_OK if @am is well-formed | 127 | * @return #GNUNET_OK if @a am is well-formed |
128 | */ | 128 | */ |
129 | static int | 129 | static int |
130 | check_announce (void *cls, | 130 | check_announce (void *cls, |
diff --git a/src/sq/sq_query_helper.c b/src/sq/sq_query_helper.c index 1f7662b95..ead1b5bdd 100644 --- a/src/sq/sq_query_helper.c +++ b/src/sq/sq_query_helper.c | |||
@@ -60,7 +60,7 @@ bind_fixed_blob (void *cls, | |||
60 | * @a ptr_size bytes. | 60 | * @a ptr_size bytes. |
61 | * | 61 | * |
62 | * @param ptr pointer to the query parameter to pass | 62 | * @param ptr pointer to the query parameter to pass |
63 | * @oaran ptr_size number of bytes in @a ptr | 63 | * @param ptr_size number of bytes in @a ptr |
64 | */ | 64 | */ |
65 | struct GNUNET_SQ_QueryParam | 65 | struct GNUNET_SQ_QueryParam |
66 | GNUNET_SQ_query_param_fixed_size (const void *ptr, | 66 | GNUNET_SQ_query_param_fixed_size (const void *ptr, |
diff --git a/src/transport/gnunet-service-tng.c b/src/transport/gnunet-service-tng.c index 7efe07fda..7ea34735b 100644 --- a/src/transport/gnunet-service-tng.c +++ b/src/transport/gnunet-service-tng.c | |||
@@ -3247,7 +3247,7 @@ struct MonitorEvent | |||
3247 | 3247 | ||
3248 | 3248 | ||
3249 | /** | 3249 | /** |
3250 | * Free a @dvh. Callers MAY want to check if this was the last path to the | 3250 | * Free a @a dvh. Callers MAY want to check if this was the last path to the |
3251 | * `target`, and if so call #free_dv_route to also free the associated DV | 3251 | * `target`, and if so call #free_dv_route to also free the associated DV |
3252 | * entry in #dv_routes (if not, the associated scheduler job should eventually | 3252 | * entry in #dv_routes (if not, the associated scheduler job should eventually |
3253 | * take care of it). | 3253 | * take care of it). |
@@ -7550,7 +7550,7 @@ check_dv_box (void *cls, const struct TransportDVBoxMessage *dvb) | |||
7550 | 7550 | ||
7551 | /** | 7551 | /** |
7552 | * Create a DV Box message and queue it for transmission to | 7552 | * Create a DV Box message and queue it for transmission to |
7553 | * @ea next_hop. | 7553 | * @a next_hop. |
7554 | * | 7554 | * |
7555 | * @param next_hop peer to receive the message next | 7555 | * @param next_hop peer to receive the message next |
7556 | * @param total_hops how many hops did the message take so far | 7556 | * @param total_hops how many hops did the message take so far |
diff --git a/src/transport/transport-testing-main.c b/src/transport/transport-testing-main.c index 20c58eeee..8d1727d77 100644 --- a/src/transport/transport-testing-main.c +++ b/src/transport/transport-testing-main.c | |||
@@ -253,7 +253,7 @@ my_nc (void *cls, | |||
253 | * | 253 | * |
254 | * @param cls our `struct GNUNET_TRANSPORT_TESTING_InternalPeerContext *` | 254 | * @param cls our `struct GNUNET_TRANSPORT_TESTING_InternalPeerContext *` |
255 | * @param peer peer we got disconnected from | 255 | * @param peer peer we got disconnected from |
256 | * @param custom_cls return value from @my_nc | 256 | * @param custom_cls return value from @a my_nc |
257 | */ | 257 | */ |
258 | static void | 258 | static void |
259 | my_nd (void *cls, | 259 | my_nd (void *cls, |
diff --git a/src/transport/transport-testing-main2.c b/src/transport/transport-testing-main2.c index 62aa3ceb7..de0b7f4cd 100644 --- a/src/transport/transport-testing-main2.c +++ b/src/transport/transport-testing-main2.c | |||
@@ -253,7 +253,7 @@ my_nc (void *cls, | |||
253 | * | 253 | * |
254 | * @param cls our `struct GNUNET_TRANSPORT_TESTING_InternalPeerContext *` | 254 | * @param cls our `struct GNUNET_TRANSPORT_TESTING_InternalPeerContext *` |
255 | * @param peer peer we got disconnected from | 255 | * @param peer peer we got disconnected from |
256 | * @param custom_cls return value from @my_nc | 256 | * @param custom_cls return value from @a my_nc |
257 | */ | 257 | */ |
258 | static void | 258 | static void |
259 | my_nd (void *cls, | 259 | my_nd (void *cls, |
diff --git a/src/transport/transport_api_monitor_plugins.c b/src/transport/transport_api_monitor_plugins.c index d8eddddaa..43a11442b 100644 --- a/src/transport/transport_api_monitor_plugins.c +++ b/src/transport/transport_api_monitor_plugins.c | |||
@@ -211,7 +211,7 @@ locate_by_id (void *cls, | |||
211 | * Function called with responses from the service. | 211 | * Function called with responses from the service. |
212 | * | 212 | * |
213 | * @param cls our `struct GNUNET_TRANSPORT_PluginMonitor *` | 213 | * @param cls our `struct GNUNET_TRANSPORT_PluginMonitor *` |
214 | * @paramm tpmm message with event data | 214 | * @param tpmm message with event data |
215 | * @return #GNUNET_Ok if message is well-formed | 215 | * @return #GNUNET_Ok if message is well-formed |
216 | */ | 216 | */ |
217 | static int | 217 | static int |
@@ -243,7 +243,7 @@ check_event (void *cls, | |||
243 | * Function called with responses from the service. | 243 | * Function called with responses from the service. |
244 | * | 244 | * |
245 | * @param cls our `struct GNUNET_TRANSPORT_PluginMonitor *` | 245 | * @param cls our `struct GNUNET_TRANSPORT_PluginMonitor *` |
246 | * @paramm tpmm message with event data | 246 | * @param tpmm message with event data |
247 | */ | 247 | */ |
248 | static void | 248 | static void |
249 | handle_event (void *cls, | 249 | handle_event (void *cls, |
diff --git a/src/util/configuration.c b/src/util/configuration.c index 27e6cf612..5c415aff7 100644 --- a/src/util/configuration.c +++ b/src/util/configuration.c | |||
@@ -91,7 +91,7 @@ struct ConfigSection | |||
91 | /** | 91 | /** |
92 | * Is the configuration section marked as inaccessible? | 92 | * Is the configuration section marked as inaccessible? |
93 | * | 93 | * |
94 | * This can happen if the section name is used in an @inline-secret@ | 94 | * This can happen if the section name is used in an \@inline-secret\@ |
95 | * directive, but the referenced file can't be found or accessed. | 95 | * directive, but the referenced file can't be found or accessed. |
96 | */ | 96 | */ |
97 | bool inaccessible; | 97 | bool inaccessible; |
@@ -135,7 +135,7 @@ struct ConfigFile | |||
135 | 135 | ||
136 | /** | 136 | /** |
137 | * Was this configuration file parsed via | 137 | * Was this configuration file parsed via |
138 | * @inline-secret@? | 138 | * \@inline-secret\@? |
139 | */ | 139 | */ |
140 | char *hint_restrict_section; | 140 | char *hint_restrict_section; |
141 | 141 | ||
diff --git a/src/util/gnunet-service-resolver.c b/src/util/gnunet-service-resolver.c index 9bde04117..8a89fbb37 100644 --- a/src/util/gnunet-service-resolver.c +++ b/src/util/gnunet-service-resolver.c | |||
@@ -314,7 +314,7 @@ extract_search_domain (const char *line, size_t line_len) | |||
314 | * Reads the list of nameservers from /etc/resolve.conf | 314 | * Reads the list of nameservers from /etc/resolve.conf |
315 | * | 315 | * |
316 | * @param server_addrs[out] a list of null-terminated server address strings | 316 | * @param server_addrs[out] a list of null-terminated server address strings |
317 | * @return the number of server addresses in @server_addrs, -1 on error | 317 | * @return the number of server addresses in @a server_addrs, -1 on error |
318 | */ | 318 | */ |
319 | static int | 319 | static int |
320 | lookup_dns_servers (char ***server_addrs) | 320 | lookup_dns_servers (char ***server_addrs) |