[Home]

Summary:ASTERISK-29763: main: Fix for Doxygen
Reporter:Alexander Traud (traud)Labels:
Date Opened:2021-11-19 10:14:39.000-0600Date Closed:2021-12-02 15:00:38.000-0600
Priority:TrivialRegression?
Status:Closed/CompleteComponents:Core/General Documentation
Versions:16.22.0 18.8.0 19.0.0 Frequency of
Occurrence
Related
Issues:
Environment:Attachments:
Description:The last report in a series, this time it is all about {{/main}}. If all {{WARN_}} are enabled in the file {{doc/asterisk-ng-doxygen.in}}, the following appears in the file {{doxygen.log}}:
{code}
main/core_local.c:432: warning: unable to resolve reference to 'optimization_finished_cb' for \ref command
main/core_local.c:389: warning: unable to resolve reference to 'optimization_started_cb' for \ref command
include/asterisk/_private.h:67: warning: documented empty return type of load_astmm_phase_1
include/asterisk/_private.h:74: warning: documented empty return type of load_astmm_phase_2
main/acl.c:255: warning: documented empty return type of ast_copy_ha
main/acl.c:222: warning: documented empty return type of ast_free_ha
include/asterisk/acl.h:114: warning: documented empty return type of ast_copy_ha
include/asterisk/acl.h:88: warning: documented empty return type of ast_free_ha
include/asterisk/acl.h:425: warning: unexpected token in comment block while parsing the argument of command retval
main/aoc.c:1403: warning: argument 'multipler' of command @param is not found in the argument list of aoc_amount_str(struct ast_str **msg, const char *prefix, unsigned int amount, enum ast_aoc_currency_multiplier mult)
main/aoc.c:1414: warning: The following parameter of aoc_amount_str(struct ast_str **msg, const char *prefix, unsigned int amount, enum ast_aoc_currency_multiplier mult) is not documented:
 parameter 'mult'
main/aoc.c:1414: warning: documented empty return type of aoc_amount_str
main/aoc.c:1835: warning: documented empty return type of aoc_publish_blob
main/aoc.c:1395: warning: documented empty return type of aoc_time_str
main/astmm.c:1557: warning: documented empty return type of load_astmm_phase_1
main/astmm.c:1561: warning: documented empty return type of load_astmm_phase_2
include/asterisk/astobj2.h:2015: warning: The following parameter of AO2_FIELD_CMP_FN(stype, fn_suffix, field, key_cmp, partial_key_cmp, transform, argconst) is not documented:
 parameter 'argconst'
main/astobj2_container.c:39: warning: The following parameters of __container_unlink_node_debug(struct ao2_container_node *node, uint32_t flags, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
main/astobj2_container_private.h:322: warning: The following parameters of __container_unlink_node_debug(struct ao2_container_node *node, uint32_t flags, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
main/astobj2_hash.c:739: warning: documented empty return type of hash_ao2_destroy
main/astobj2_hash.c:145: warning: documented empty return type of hash_ao2_node_destructor
main/astobj2_rbtree.c:1680: warning: documented empty return type of rb_ao2_destroy
main/astobj2_rbtree.c:838: warning: documented empty return type of rb_ao2_node_destructor
main/astobj2_rbtree.c:584: warning: documented empty return type of rb_delete_fixup
main/astobj2_rbtree.c:720: warning: documented empty return type of rb_delete_node
main/astobj2_rbtree.c:933: warning: documented empty return type of rb_insert_fixup
main/astobj2_rbtree.c:459: warning: documented empty return type of rb_rotate_left
main/astobj2_rbtree.c:514: warning: documented empty return type of rb_rotate_right
main/autochan.c:64: warning: documented empty return type of ast_autochan_destroy
main/autochan.c:86: warning: documented empty return type of ast_autochan_new_channel
include/asterisk/autochan.h:119: warning: documented empty return type of ast_autochan_destroy
include/asterisk/autochan.h:137: warning: documented empty return type of ast_autochan_new_channel
main/callerid.c:188: warning: documented empty return type of callerid_get
include/asterisk/callerid.h:233: warning: documented empty return type of ast_shrink_phone_number
include/asterisk/callerid.h:156: warning: documented empty return type of callerid_get
include/asterisk/cli.h:364: warning: argument 'ast_cli_args' of command @param is not found in the argument list of ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix)
include/asterisk/cli.h:364: warning: argument 'duration' of command @param is not found in the argument list of ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix)
main/cli.c:3021: warning: The following parameters of ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix) are not documented:
 parameter 'fd'
 parameter 'seconds'
include/asterisk/cli.h:364: warning: argument 'ast_cli_args' of command @param is not found in the argument list of ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix)
include/asterisk/cli.h:364: warning: argument 'duration' of command @param is not found in the argument list of ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix)
include/asterisk/cli.h:372: warning: The following parameters of ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix) are not documented:
 parameter 'fd'
 parameter 'seconds'
main/core_local.c:432: warning: unable to resolve reference to 'optimization_finished_cb' for \ref command
main/core_local.c:389: warning: unable to resolve reference to 'optimization_started_cb' for \ref command
main/core_local.c:432: warning: unable to resolve reference to 'optimization_finished_cb' for \ref command
main/core_local.c:389: warning: unable to resolve reference to 'optimization_started_cb' for \ref command
main/core_local.c:846: warning: documented empty return type of local_pvt_destructor
main/core_local.c:1122: warning: documented empty return type of local_shutdown
main/core_local.c:540: warning: documented empty return type of publish_local_bridge_message
include/asterisk/core_unreal.h:198: warning: argument 'cap' of command @param is not found in the argument list of ast_unreal_alloc_stream_topology(size_t size, ao2_destructor_fn destructor, struct ast_stream_topology *topology)
main/core_unreal.c:1126: warning: The following parameter of ast_unreal_alloc_stream_topology(size_t size, ao2_destructor_fn destructor, struct ast_stream_topology *topology) is not documented:
 parameter 'topology'
main/core_unreal.c:870: warning: documented empty return type of ast_unreal_call_setup
main/core_unreal.c:1097: warning: documented empty return type of ast_unreal_destructor
main/core_unreal.c:1160: warning: The following parameter of ast_unreal_new_channels(struct ast_unreal_pvt *p, const struct ast_channel_tech *tech, int semi1_state, int semi2_state, const char *exten, const char *context, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, ast_callid callid) is not documented:
 parameter 'assignedids'
include/asterisk/core_unreal.h:198: warning: argument 'cap' of command @param is not found in the argument list of ast_unreal_alloc_stream_topology(size_t size, ao2_destructor_fn destructor, struct ast_stream_topology *topology)
include/asterisk/core_unreal.h:209: warning: The following parameter of ast_unreal_alloc_stream_topology(size_t size, ao2_destructor_fn destructor, struct ast_stream_topology *topology) is not documented:
 parameter 'topology'
include/asterisk/core_unreal.h:243: warning: documented empty return type of ast_unreal_call_setup
include/asterisk/core_unreal.h:182: warning: documented empty return type of ast_unreal_destructor
include/asterisk/core_unreal.h:227: warning: The following parameter of ast_unreal_new_channels(struct ast_unreal_pvt *p, const struct ast_channel_tech *tech, int semi1_state, int semi2_state, const char *exten, const char *context, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, ast_callid callid) is not documented:
 parameter 'assignedids'
main/crypt.c:61: warning: argument 'max_len' of command @param is not found in the argument list of gen_salt(char *current_salt, size_t maxlen)
main/crypt.c:72: warning: The following parameter of gen_salt(char *current_salt, size_t maxlen) is not documented:
 parameter 'maxlen'
include/asterisk/crypto.h:70: warning: argument 'sig' of command @param is not found in the argument list of ast_check_signature_bin(struct ast_key *key, const char *msg, int msglen, const unsigned char *dsig)
include/asterisk/crypto.h:80: warning: The following parameter of ast_check_signature_bin(struct ast_key *key, const char *msg, int msglen, const unsigned char *dsig) is not documented:
 parameter 'dsig'
include/asterisk/crypto.h:48: warning: argument 'key' of command @param is not found in the argument list of ast_key_get(const char *kname, int ktype)
include/asterisk/crypto.h:48: warning: argument 'type' of command @param is not found in the argument list of ast_key_get(const char *kname, int ktype)
include/asterisk/crypto.h:55: warning: The following parameters of ast_key_get(const char *kname, int ktype) are not documented:
 parameter 'kname'
 parameter 'ktype'
include/asterisk/crypto.h:96: warning: argument 'sig' of command @param is not found in the argument list of ast_sign_bin(struct ast_key *key, const char *msg, int msglen, unsigned char *dsig)
include/asterisk/crypto.h:107: warning: The following parameter of ast_sign_bin(struct ast_key *key, const char *msg, int msglen, unsigned char *dsig) is not documented:
 parameter 'dsig'
include/asterisk/data_buffer.h:46: warning: argument 'The' of command @param is not found in the argument list of ast_data_buffer_free_callback(void *data)
include/asterisk/data_buffer.h:48: warning: The following parameter of ast_data_buffer_free_callback(void *data) is not documented:
 parameter 'data'
include/asterisk/devicestate.h:298: warning: argument 'The' of command @param is not found in the argument list of ast_device_state_clear_cache(const char *device)
main/devicestate.c:688: warning: The following parameter of ast_device_state_clear_cache(const char *device) is not documented:
 parameter 'device'
include/asterisk/devicestate.h:266: warning: argument 'uniqueid' of command @param is not found in the argument list of ast_device_state_topic(const char *device)
main/devicestate.c:683: warning: The following parameter of ast_device_state_topic(const char *device) is not documented:
 parameter 'device'
main/devicestate.c:636: warning: documented empty return type of ast_devstate_aggregate_add
main/devicestate.c:630: warning: documented empty return type of ast_devstate_aggregate_init
main/devicestate.c:787: warning: documented empty return type of device_state_aggregate_publish
include/asterisk/devicestate.h:298: warning: argument 'The' of command @param is not found in the argument list of ast_device_state_clear_cache(const char *device)
include/asterisk/devicestate.h:304: warning: The following parameter of ast_device_state_clear_cache(const char *device) is not documented:
 parameter 'device'
include/asterisk/devicestate.h:266: warning: argument 'uniqueid' of command @param is not found in the argument list of ast_device_state_topic(const char *device)
include/asterisk/devicestate.h:272: warning: The following parameter of ast_device_state_topic(const char *device) is not documented:
 parameter 'device'
include/asterisk/devicestate.h:213: warning: documented empty return type of ast_devstate_aggregate_add
include/asterisk/devicestate.h:202: warning: documented empty return type of ast_devstate_aggregate_init
include/asterisk/dial.h:95: warning: Found unknown command '\reval'
main/dial.c:1313: warning: documented empty return type of ast_dial_set_global_timeout
main/dial.c:1293: warning: documented empty return type of ast_dial_set_state_callback
main/dial.c:1329: warning: documented empty return type of ast_dial_set_timeout
main/dial.c:1298: warning: documented empty return type of ast_dial_set_user_data
include/asterisk/dial.h:141: warning: argument 'dial' from the argument list of ast_dial_destroy has multiple @param documentation sections
include/asterisk/dial.h:95: warning: Found unknown command '\reval'
include/asterisk/dial.h:214: warning: argument 'dial' from the argument list of ast_dial_set_global_timeout has multiple @param documentation sections
include/asterisk/dial.h:214: warning: argument 'timeout' from the argument list of ast_dial_set_global_timeout has multiple @param documentation sections
include/asterisk/dial.h:214: warning: documented empty return type of ast_dial_set_global_timeout
include/asterisk/dial.h:194: warning: documented empty return type of ast_dial_set_state_callback
include/asterisk/dial.h:222: warning: argument 'dial' from the argument list of ast_dial_set_timeout has multiple @param documentation sections
include/asterisk/dial.h:222: warning: argument 'num' from the argument list of ast_dial_set_timeout has multiple @param documentation sections
include/asterisk/dial.h:222: warning: argument 'timeout' from the argument list of ast_dial_set_timeout has multiple @param documentation sections
include/asterisk/dial.h:222: warning: documented empty return type of ast_dial_set_timeout
include/asterisk/dial.h:201: warning: documented empty return type of ast_dial_set_user_data
main/dns.c:316: warning: argument 'dname' of command @param is not found in the argument list of dns_parse_answer(void *context, int class, int type, unsigned char *answer, int len, int(*callback)(void *context, unsigned char *answer, int len, unsigned char *fullanswer))
main/dns.c:391: warning: argument 'dname' of command @param is not found in the argument list of dns_parse_answer_ex(void *context, int rr_class, int rr_type, unsigned char *answer, int answer_len, int(*response_handler)(void *context, unsigned char *dns_response, int dns_response_len, int rcode), int(*record_handler)(void *context, unsigned char *record, int record_len, int ttl))
include/asterisk/dns.h:35: warning: argument 'answer' of command @param is not found in the argument list of ast_search_dns(void *context, const char *dname, int class, int type, int(*callback)(void *context, unsigned char *answer, int len, unsigned char *fullanswer))
include/asterisk/dns.h:35: warning: argument 'len' of command @param is not found in the argument list of ast_search_dns(void *context, const char *dname, int class, int type, int(*callback)(void *context, unsigned char *answer, int len, unsigned char *fullanswer))
include/asterisk/dns_resolver.h:85: warning: argument 'result' of command @param is not found in the argument list of ast_dns_resolver_set_result(struct ast_dns_query *query, unsigned int secure, unsigned int bogus, unsigned int rcode, const char *canonical, const char *answer, size_t answer_size)
main/dns_core.c:456: warning: The following parameter of ast_dns_resolver_set_result(struct ast_dns_query *query, unsigned int secure, unsigned int bogus, unsigned int rcode, const char *canonical, const char *answer, size_t answer_size) is not documented:
 parameter 'secure'
include/asterisk/dns_core.h:112: warning: argument 'query' of command @param is not found in the argument list of ast_dns_result_get_rcode(const struct ast_dns_result *result)
main/dns_core.c:92: warning: The following parameter of ast_dns_result_get_rcode(const struct ast_dns_result *result) is not documented:
 parameter 'result'
include/asterisk/dns_core.h:112: warning: argument 'query' of command @param is not found in the argument list of ast_dns_result_get_rcode(const struct ast_dns_result *result)
include/asterisk/dns_core.h:116: warning: The following parameter of ast_dns_result_get_rcode(const struct ast_dns_result *result) is not documented:
 parameter 'result'
main/dns_naptr.c:63: warning: Found unknown command '\flags_size'
main/dns_naptr.c:1: warning: The following parameter of interpret_flags(const char *flags, uint8_t flags_size) is not documented:
 parameter 'flags_size'
include/asterisk/dns_recurring.h:63: warning: argument 'query' of command @param is not found in the argument list of ast_dns_resolve_recurring_cancel(struct ast_dns_query_recurring *recurring)
main/dns_recurring.c:143: warning: The following parameter of ast_dns_resolve_recurring_cancel(struct ast_dns_query_recurring *recurring) is not documented:
 parameter 'recurring'
include/asterisk/dns_recurring.h:63: warning: argument 'query' of command @param is not found in the argument list of ast_dns_resolve_recurring_cancel(struct ast_dns_query_recurring *recurring)
include/asterisk/dns_recurring.h:72: warning: The following parameter of ast_dns_resolve_recurring_cancel(struct ast_dns_query_recurring *recurring) is not documented:
 parameter 'recurring'
include/asterisk/dns_resolver.h:85: warning: argument 'result' of command @param is not found in the argument list of ast_dns_resolver_set_result(struct ast_dns_query *query, unsigned int secure, unsigned int bogus, unsigned int rcode, const char *canonical, const char *answer, size_t answer_size)
include/asterisk/dns_resolver.h:100: warning: The following parameter of ast_dns_resolver_set_result(struct ast_dns_query *query, unsigned int secure, unsigned int bogus, unsigned int rcode, const char *canonical, const char *answer, size_t answer_size) is not documented:
 parameter 'secure'
main/dns_system_resolver.c:23: warning: unable to resolve reference to 'res_resolver_unbound' for \ref command
main/dns_system_resolver.c:210: warning: argument 'dns_response' from the argument list of dns_system_resolver_set_response has multiple @param documentation sections
main/dns_system_resolver.c:210: warning: The following parameters of dns_system_resolver_set_response(void *context, unsigned char *dns_response, int dns_response_len, int rcode) are not documented:
 parameter 'context'
 parameter 'dns_response_len'
main/dnsmgr.c:136: warning: documented empty return type of ast_dnsmgr_release
include/asterisk/dnsmgr.h:86: warning: documented empty return type of ast_dnsmgr_release
main/event.c:524: warning: documented empty return type of ast_event_destroy
include/asterisk/event.h:107: warning: documented empty return type of ast_event_destroy
include/asterisk/event_defs.h:338: warning: unable to resolve reference to 'ast_event_check_subscriber()' for \ref command

main/features.c:486: warning: documented empty return type of bridge_check_monitor
main/features.c:528: warning: documented empty return type of bridge_failed_peer_goto
include/asterisk/features_config.h:199: warning: argument 'size' of command @param is not found in the argument list of ast_get_builtin_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len)
main/features_config.c:1233: warning: The following parameter of ast_get_builtin_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len) is not documented:
 parameter 'len'
include/asterisk/features_config.h:215: warning: argument 'size' of command @param is not found in the argument list of ast_get_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len)
main/features_config.c:1250: warning: The following parameter of ast_get_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len) is not documented:
 parameter 'len'
include/asterisk/features_config.h:199: warning: argument 'size' of command @param is not found in the argument list of ast_get_builtin_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len)
include/asterisk/features_config.h:210: warning: The following parameter of ast_get_builtin_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len) is not documented:
 parameter 'len'
include/asterisk/features_config.h:215: warning: argument 'size' of command @param is not found in the argument list of ast_get_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len)
include/asterisk/features_config.h:229: warning: The following parameter of ast_get_feature(struct ast_channel *chan, const char *feature, char *buf, size_t len) is not documented:
 parameter 'len'
main/file.c:1745: warning: return value 'the' of ast_waitstream_fr has multiple documentation sections
main/file.c:1734: warning: return value 'the' of ast_waitstream_fr_w_cb has multiple documentation sections
include/asterisk/file.h:211: warning: return value 'the' of ast_waitstream_fr has multiple documentation sections
include/asterisk/file.h:229: warning: return value 'the' of ast_waitstream_fr_w_cb has multiple documentation sections
include/asterisk/format.h:304: warning: argument 'The' of command @param is not found in the argument list of ast_format_get_channel_count(const struct ast_format *format)
main/format.c:135: warning: The following parameter of ast_format_get_channel_count(const struct ast_format *format) is not documented:
 parameter 'format'
include/asterisk/format.h:304: warning: argument 'The' of command @param is not found in the argument list of ast_format_get_channel_count(const struct ast_format *format)
include/asterisk/format.h:308: warning: The following parameter of ast_format_get_channel_count(const struct ast_format *format) is not documented:
 parameter 'format'
main/format_cache.c:502: warning: The following parameters of __ast_format_cache_get(const char *name, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
include/asterisk/format_cache.h:278: warning: The following parameters of __ast_format_cache_get(const char *name, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
main/format_cap.c:117: warning: The following parameters of __ast_format_cap_alloc(enum ast_format_cap_flags flags, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
main/format_cap.c:195: warning: The following parameters of __ast_format_cap_append(struct ast_format_cap *cap, struct ast_format *format, unsigned int framing, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
main/format_cap.c:497: warning: return value 'remove' of ast_format_cap_remove has multiple documentation sections
include/asterisk/format_cap.h:49: warning: The following parameters of __ast_format_cap_alloc(enum ast_format_cap_flags flags, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
include/asterisk/format_cap.h:100: warning: The following parameters of __ast_format_cap_append(struct ast_format_cap *cap, struct ast_format *format, unsigned int framing, const char *tag, const char *file, int line, const char *func) are not documented:
 parameter 'tag'
 parameter 'file'
 parameter 'line'
 parameter 'func'
include/asterisk/format_cap.h:224: warning: return value 'remove' of ast_format_cap_remove has multiple documentation sections
main/hashtab.c:216: warning: The following parameters of _ast_hashtab_create(int initial_buckets, int(*compare)(const void *a, const void *b), int(*resize)(struct ast_hashtab *), int(*newsize)(struct ast_hashtab *tab), unsigned int(*hash)(const void *obj), int do_locking, const char *file, int lineno, const char *function) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'function'
main/hashtab.c:404: warning: The following parameters of _ast_hashtab_insert_immediate(struct ast_hashtab *tab, const void *obj, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/hashtab.c:425: warning: The following parameters of _ast_hashtab_insert_immediate_bucket(struct ast_hashtab *tab, const void *obj, unsigned int h, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/hashtab.h:254: warning: The following parameters of _ast_hashtab_create(int initial_buckets, int(*compare)(const void *a, const void *b), int(*resize)(struct ast_hashtab *), int(*newsize)(struct ast_hashtab *tab), unsigned int(*hash)(const void *obj), int do_locking, const char *file, int lineno, const char *function) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'function'
include/asterisk/hashtab.h:290: warning: The following parameters of _ast_hashtab_insert_immediate(struct ast_hashtab *tab, const void *obj, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/hashtab.h:304: warning: The following parameters of _ast_hashtab_insert_immediate_bucket(struct ast_hashtab *tab, const void *obj, unsigned int h, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/heap.c:112: warning: The following parameters of _ast_heap_create(unsigned int init_height, ast_heap_cmp_fn cmp_fn, ssize_t index_offset, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/heap.c:222: warning: The following parameters of _ast_heap_push(struct ast_heap *h, void *elm, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/heap.h:100: warning: The following parameters of _ast_heap_create(unsigned int init_height, ast_heap_cmp_fn cmp_fn, ssize_t index_offset, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/heap.h:125: warning: The following parameters of _ast_heap_push(struct ast_heap *h, void *elm, const char *file, int lineno, const char *func) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/http.c:899: warning: documented empty return type of ast_http_body_read_status
main/http.c:836: warning: documented empty return type of ast_http_request_close_on_completion
main/http.c:852: warning: documented empty return type of http_request_tracking_init
include/asterisk/http.h:263: warning: documented empty return type of ast_http_body_read_status
include/asterisk/http.h:252: warning: documented empty return type of ast_http_request_close_on_completion
include/asterisk/io.h:153: warning: argument 'fd' of command @param is not found in the argument list of ast_sd_get_fd(int type, const struct ast_sockaddr *addr)
include/asterisk/io.h:153: warning: argument 'fd' of command @param is not found in the argument list of ast_sd_get_fd(int type, const struct ast_sockaddr *addr)
include/asterisk/io.h:162: warning: argument 'type' from the argument list of ast_sd_get_fd has multiple @param documentation sections
include/asterisk/io.h:162: warning: argument 'addr' from the argument list of ast_sd_get_fd has multiple @param documentation sections
main/iostream.c:103: warning: documented empty return type of ast_iostream_nonblock
main/iostream.c:148: warning: documented empty return type of ast_iostream_set_exclusive_input
main/iostream.c:113: warning: documented empty return type of ast_iostream_set_timeout_disable
main/iostream.c:130: warning: documented empty return type of ast_iostream_set_timeout_idle_inactivity
main/iostream.c:121: warning: documented empty return type of ast_iostream_set_timeout_inactivity
main/iostream.c:139: warning: documented empty return type of ast_iostream_set_timeout_sequence
include/asterisk/iostream.h:150: warning: documented empty return type of ast_iostream_nonblock
include/asterisk/iostream.h:117: warning: documented empty return type of ast_iostream_set_exclusive_input
include/asterisk/iostream.h:49: warning: documented empty return type of ast_iostream_set_timeout_disable
include/asterisk/iostream.h:85: warning: documented empty return type of ast_iostream_set_timeout_idle_inactivity
include/asterisk/iostream.h:65: warning: documented empty return type of ast_iostream_set_timeout_inactivity
include/asterisk/iostream.h:103: warning: documented empty return type of ast_iostream_set_timeout_sequence
include/asterisk/json.h:747: warning: Found unknown command '\iter'
include/asterisk/json.h:408: warning: argument 'integer' of command @param is not found in the argument list of ast_json_real_set(struct ast_json *real, double value)
main/json.c:342: warning: The following parameter of ast_json_real_set(struct ast_json *real, double value) is not documented:
 parameter 'real'
main/json.c:293: warning: The following parameter of ast_json_vstringf(const char *format, va_list args) is not documented:
 parameter 'args'
include/asterisk/json.h:585: warning: argument 'integer' of command @param is not found in the argument list of ast_json_object_integer_get(object, key)
include/asterisk/json.h:590: warning: The following parameters of ast_json_object_integer_get(object, key) are not documented:
 parameter 'object'
 parameter 'key'
include/asterisk/json.h:747: warning: Found unknown command '\iter'
include/asterisk/json.h:408: warning: argument 'integer' of command @param is not found in the argument list of ast_json_real_set(struct ast_json *real, double value)
include/asterisk/json.h:415: warning: The following parameter of ast_json_real_set(struct ast_json *real, double value) is not documented:
 parameter 'real'
include/asterisk/json.h:355: warning: The following parameter of ast_json_vstringf(const char *format, va_list args) is not documented:
 parameter 'args'
include/asterisk/max_forwards.h:59: warning: Found unknown command '\chan'
include/asterisk/max_forwards.h:59: warning: Found unknown command '\chan'
main/media_cache.c:132: warning: The following parameter of bucket_file_update_path(struct ast_bucket_file *bucket_file, const char *preferred_file_name) is not documented:
 parameter 'bucket_file'
main/message.c:1193: warning: unexpected token in comment block while parsing the argument of command retval
main/message.c:1219: warning: unexpected token in comment block while parsing the argument of command retval
include/asterisk/multicast_rtp.h:54: warning: Found unknown command '\revval'
include/asterisk/mwi.h:485: warning: unexpected token in comment block while parsing the argument of command retval
main/mwi.c:173: warning: The following parameter of mwi_state_create_message(const char *mailbox, const char *context, int urgent_msgs, int new_msgs, int old_msgs, const char *channel_id, struct ast_eid *eid) is not documented:
 parameter 'urgent_msgs'
include/asterisk/mwi.h:36: warning: unable to resolve reference to 'ast_mwi_callback' for \ref command
include/asterisk/mwi.h:485: warning: unexpected token in comment block while parsing the argument of command retval
include/asterisk/netsock2.h:171: warning: documented empty return type of ast_sockaddr_copy
include/asterisk/netsock2.h:154: warning: documented empty return type of ast_sockaddr_copy_sockaddr
include/asterisk/netsock2.h:457: warning: argument 'flags' of command @param is not found in the argument list of ast_sockaddr_resolve_first_af(struct ast_sockaddr *addr, const char *name, int flag, int family)
include/asterisk/netsock2.h:489: warning: The following parameter of ast_sockaddr_resolve_first_af(struct ast_sockaddr *addr, const char *name, int flag, int family) is not documented:
 parameter 'flag'
include/asterisk/netsock2.h:140: warning: documented empty return type of ast_sockaddr_setnull
include/asterisk/pickup.h:59: warning: argument 'chan' from the argument list of ast_pickup_call has multiple @param documentation sections
include/asterisk/multicast_rtp.h:54: warning: Found unknown command '\revval'
main/rtp_engine.c:1022: warning: documented empty return type of payload_mapping_rx_clear_primary
main/rtp_engine.c:1079: warning: documented empty return type of rtp_codecs_payload_replace_rx
main/rtp_engine.c:1108: warning: documented empty return type of rtp_codecs_payloads_copy_rx
main/rtp_engine.c:1193: warning: documented empty return type of rtp_codecs_payloads_copy_tx
include/asterisk/sched.h:320: warning: argument 'con' from the argument list of ast_sched_runq has multiple @param documentation sections
include/asterisk/sdp_srtp.h:176: warning: argument 'p' of command @param is not found in the argument list of ast_sdp_crypto_process(struct ast_rtp_instance *rtp, struct ast_sdp_srtp *srtp, const char *attr)
main/sdp_srtp.c:132: warning: documented empty return type of ast_sdp_crypto_unregister
include/asterisk/sdp_srtp.h:98: warning: argument 'p' of command @param is not found in the argument list of sdp_crypto_parse_offer_cb(struct ast_rtp_instance *rtp, struct ast_sdp_srtp *srtp, const char *attr)
include/asterisk/sdp_srtp.h:176: warning: argument 'p' of command @param is not found in the argument list of ast_sdp_crypto_process(struct ast_rtp_instance *rtp, struct ast_sdp_srtp *srtp, const char *attr)
include/asterisk/sdp_srtp.h:159: warning: documented empty return type of ast_sdp_crypto_unregister
include/asterisk/security_events.h:62: warning: unexpected token in comment block while parsing the argument of command retval
include/asterisk/security_events.h:72: warning: unexpected token in comment block while parsing the argument of command retval
include/asterisk/security_events.h:62: warning: unexpected token in comment block while parsing the argument of command retval
include/asterisk/sem.h:158: warning: The following parameter of ast_sem_timedwait(struct ast_sem *sem, const struct timespec *abs_timeout) is not documented:
 parameter 'abs_timeout'
main/serializer.c:156: warning: The following parameters of ast_serializer_pool_set_alerts(struct ast_serializer_pool *pool, long high, long low) are not documented:
 parameter 'high'
 parameter 'low'
include/asterisk/serializer.h:83: warning: The following parameters of ast_serializer_pool_set_alerts(struct ast_serializer_pool *pool, long high, long low) are not documented:
 parameter 'high'
 parameter 'low'
main/sha1.c:346: warning: documented empty return type of SHA1Finalize
main/sha1.c:374: warning: documented empty return type of SHA1PadMessage
main/sha1.c:260: warning: documented empty return type of SHA1ProcessMessageBlock
main/slinfactory.c:58: warning: documented empty return type of ast_slinfactory_destroy
main/slinfactory.c:204: warning: documented empty return type of ast_slinfactory_flush
main/slinfactory.c:39: warning: documented empty return type of ast_slinfactory_init
include/asterisk/slinfactory.h:76: warning: documented empty return type of ast_slinfactory_destroy
include/asterisk/slinfactory.h:115: warning: documented empty return type of ast_slinfactory_flush
include/asterisk/slinfactory.h:53: warning: documented empty return type of ast_slinfactory_init
main/smoother.c:86: warning: documented empty return type of ast_smoother_reconfigure
include/asterisk/smoother.h:73: warning: documented empty return type of ast_smoother_reconfigure
main/srv.c:27: warning: unable to resolve reference to 'AstENUM' for \ref command
include/asterisk/stringfields.h:252: warning: argument 'fields' of command @param is not found in the argument list of __ast_string_field_alloc_space(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, size_t needed, const char *file, int lineno, const char *func)
main/stringfields.c:202: warning: The following parameters of __ast_string_field_alloc_space(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, size_t needed, const char *file, int lineno, const char *func) are not documented:
 parameter 'pool_head'
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/stringfields.c:369: warning: The following parameters of __ast_string_field_ptr_build(const char *file, int lineno, const char *func, struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, ast_string_field *ptr, const char *format,...) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/stringfields.c:369: warning: documented empty return type of __ast_string_field_ptr_build
include/asterisk/stringfields.h:281: warning: argument 'args' of command @param is not found in the argument list of __ast_string_field_ptr_build_va(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, ast_string_field *ptr, const char *format, va_list ap, const char *file, int lineno, const char *func)
main/stringfields.c:286: warning: The following parameters of __ast_string_field_ptr_build_va(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, ast_string_field *ptr, const char *format, va_list ap, const char *file, int lineno, const char *func) are not documented:
 parameter 'ap'
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
main/stringfields.c:286: warning: documented empty return type of __ast_string_field_ptr_build_va
main/stringfields.c:240: warning: The following parameter of __ast_string_field_ptr_grow(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, size_t needed, const ast_string_field *ptr) is not documented:
 parameter 'pool_head'
main/stringfields.c:261: warning: documented empty return type of __ast_string_field_release_active
include/asterisk/stringfields.h:252: warning: argument 'fields' of command @param is not found in the argument list of __ast_string_field_alloc_space(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, size_t needed, const char *file, int lineno, const char *func)
include/asterisk/stringfields.h:263: warning: The following parameters of __ast_string_field_alloc_space(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, size_t needed, const char *file, int lineno, const char *func) are not documented:
 parameter 'pool_head'
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/stringfields.h:276: warning: The following parameters of __ast_string_field_ptr_build(const char *file, int lineno, const char *func, struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, ast_string_field *ptr, const char *format,...) are not documented:
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/stringfields.h:276: warning: documented empty return type of __ast_string_field_ptr_build
include/asterisk/stringfields.h:281: warning: argument 'args' of command @param is not found in the argument list of __ast_string_field_ptr_build_va(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, ast_string_field *ptr, const char *format, va_list ap, const char *file, int lineno, const char *func)
include/asterisk/stringfields.h:290: warning: The following parameters of __ast_string_field_ptr_build_va(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, ast_string_field *ptr, const char *format, va_list ap, const char *file, int lineno, const char *func) are not documented:
 parameter 'ap'
 parameter 'file'
 parameter 'lineno'
 parameter 'func'
include/asterisk/stringfields.h:290: warning: documented empty return type of __ast_string_field_ptr_build_va
include/asterisk/stringfields.h:247: warning: The following parameter of __ast_string_field_ptr_grow(struct ast_string_field_mgr *mgr, struct ast_string_field_pool **pool_head, size_t needed, const ast_string_field *ptr) is not documented:
 parameter 'pool_head'
include/asterisk/stringfields.h:450: warning: documented empty return type of __ast_string_field_release_active
include/asterisk/strings.h:1437: warning: Found unknown command '\r'
include/asterisk/strings.h:1441: warning: Found unknown command '\r'
include/asterisk/vector.h:72: warning: unable to resolve reference to 'enum' for \ref command
include/asterisk/strings.h:401: warning: documented empty return type of ast_copy_string
include/asterisk/strings.h:468: warning: return value '0' of ast_false has multiple documentation sections
include/asterisk/strings.h:1437: warning: Found unknown command '\r'
include/asterisk/strings.h:1441: warning: Found unknown command '\r'
include/asterisk/strings.h:456: warning: return value '0' of ast_true has multiple documentation sections
main/taskprocessor.c:1295: warning: documented empty return type of ast_taskprocessor_build_name
include/asterisk/taskprocessor.h:181: warning: Found unknown command '\reval'
main/taskprocessor.c:794: warning: documented empty return type of tps_alert_add
include/asterisk/taskprocessor.h:331: warning: documented empty return type of ast_taskprocessor_build_name
include/asterisk/taskprocessor.h:181: warning: Found unknown command '\reval'
main/tdd.c:282: warning: argument 'outbuf' of command @param is not found in the argument list of tdd_gen_holdtone(unsigned char *buf)
main/tdd.c:282: warning: argument 'outbuf' of command @param is not found in the argument list of tdd_gen_holdtone(unsigned char *buf)
main/tdd.c:282: warning: argument 'outbuf' of command @param is not found in the argument list of tdd_gen_holdtone(unsigned char *buf)
main/threadpool.c:491: warning: The following parameter of activate_thread(void *obj, void *arg, int flags) is not documented:
 parameter 'flags'
main/threadpool.c:522: warning: Found unknown command '\delta'
main/threadpool.c:524: warning: The following parameter of grow(struct ast_threadpool *pool, int delta) is not documented:
 parameter 'delta'
main/threadpool.c:1305: warning: documented empty return type of serializer_shutdown_group_dec
main/threadpool.c:1289: warning: documented empty return type of serializer_shutdown_group_inc
include/asterisk/threadstorage.h:262: warning: The following parameter of ast_threadstorage_set_ptr(struct ast_threadstorage *ts, void *ptr) is not documented:
 parameter 'ptr'
main/timing.c:154: warning: documented empty return type of ast_timer_close
include/asterisk/timing.h:130: warning: documented empty return type of ast_timer_close
main/translate.c:1571: warning: documented empty return type of ast_translate_available_formats
main/translate.c:1361: warning: documented empty return type of ast_translator_activate
main/translate.c:1369: warning: documented empty return type of ast_translator_deactivate
include/asterisk/translate.h:355: warning: documented empty return type of ast_translate_available_formats
include/asterisk/translate.h:274: warning: documented empty return type of ast_translator_activate
include/asterisk/translate.h:283: warning: documented empty return type of ast_translator_deactivate
main/udptl.c:1112: warning: documented empty return type of ast_udptl_set_tag
include/asterisk/udptl.h:66: warning: documented empty return type of ast_udptl_set_tag
main/utf8.c:133: warning: documented empty return type of ast_utf8_copy_string
include/asterisk/utf8.h:69: warning: documented empty return type of ast_utf8_copy_string
include/asterisk/utils.h:970: warning: argument 'version1.' of command @param is not found in the argument list of ast_compare_versions(const char *version1, const char *version2)
include/asterisk/utils.h:970: warning: argument 'version2.' of command @param is not found in the argument list of ast_compare_versions(const char *version1, const char *version2)
main/utils.c:2872: warning: The following parameters of ast_compare_versions(const char *version1, const char *version2) are not documented:
 parameter 'version1'
 parameter 'version2'
main/utils.c:2221: warning: documented empty return type of ast_enable_packet_fragmentation
main/utils.c:1968: warning: return value '0' of ast_false has multiple documentation sections
main/utils.c:2336: warning: The following parameter of ast_safe_mkdir(const char *base_path, const char *path, int mode) is not documented:
 parameter 'base_path'
main/utils.c:1951: warning: return value '0' of ast_true has multiple documentation sections
include/asterisk/utils.h:970: warning: argument 'version1.' of command @param is not found in the argument list of ast_compare_versions(const char *version1, const char *version2)
include/asterisk/utils.h:970: warning: argument 'version2.' of command @param is not found in the argument list of ast_compare_versions(const char *version1, const char *version2)
include/asterisk/utils.h:980: warning: The following parameters of ast_compare_versions(const char *version1, const char *version2) are not documented:
 parameter 'version1'
 parameter 'version2'
include/asterisk/utils.h:614: warning: documented empty return type of ast_enable_packet_fragmentation
include/asterisk/utils.h:637: warning: The following parameter of ast_safe_mkdir(const char *base_path, const char *path, int mode) is not documented:
 parameter 'base_path'
main/uuid.c:52: warning: documented empty return type of generate_uuid
include/asterisk/vector.h:749: warning: argument 'elem' of command @param is not found in the argument list of AST_VECTOR_MATCH_ALL(element)
include/asterisk/vector.h:749: warning: argument 'value' of command @param is not found in the argument list of AST_VECTOR_MATCH_ALL(element)
include/asterisk/vector.h:754: warning: The following parameter of AST_VECTOR_MATCH_ALL(element) is not documented:
 parameter 'element'
include/asterisk/vector.h:403: warning: argument 'preserve_order' of command @param is not found in the argument list of AST_VECTOR_REMOVE(vec, idx, preserve_ordered)
include/asterisk/vector.h:412: warning: The following parameter of AST_VECTOR_REMOVE(vec, idx, preserve_ordered) is not documented:
 parameter 'preserve_ordered'
include/asterisk/vector.h:624: warning: argument 'callback' of command @param is not found in the argument list of AST_VECTOR_RESET(vec, cleanup)
include/asterisk/vector.h:627: warning: The following parameter of AST_VECTOR_RESET(vec, cleanup) is not documented:
 parameter 'cleanup'
include/asterisk/vector.h:930: warning: The following parameter of AST_VECTOR_RW_RDLOCK_TIMED(vec, timespec) is not documented:
 parameter 'timespec'
include/asterisk/vector.h:940: warning: The following parameter of AST_VECTOR_RW_WRLOCK_TIMED(vec, timespec) is not documented:
 parameter 'timespec'
include/asterisk/vector.h:72: warning: unable to resolve reference to 'enum' for \ref command
main/xml.c:180: warning: documented empty return type of ast_xml_close
include/asterisk/xml.h:107: warning: documented empty return type of ast_xml_close
include/asterisk/doxyref.h:46: warning: unable to resolve reference to 'AJI_intro' for \ref command
include/asterisk/doxyref.h:50: warning: unable to resolve reference to 'AstENUM' for \ref command
include/asterisk/doxyref.h:52: warning: unable to resolve reference to 'AstSpeech' for \ref command
include/asterisk/doxyref.h:55: warning: unable to resolve reference to 'AstDebug' for \ref command
include/asterisk/doxyref.h:57: warning: unable to resolve reference to 'ConfigFiles' for \ref command
include/asterisk/doxyref.h:84: warning: unable to resolve reference to 'DataStores' for \ref command
include/asterisk/doxyref.h:86: warning: unable to resolve reference to 'AstDataRetrieval' for \ref command
include/asterisk/doxyref.h:166: warning: unable to resolve reference to 'Config_cdr' for \ref command
main/devicestate.c:102: warning: unable to resolve reference to 'AstENUM' for \ref command
include/asterisk/message.h:483: warning: argument 'source' of command @param is not found in the argument list of ast_msg_data_alloc2(enum ast_msg_data_source_type source_type, const char *to, const char *from, const char *content_type, const char *body)
include/asterisk/message.h:497: warning: The following parameter of ast_msg_data_alloc2(enum ast_msg_data_source_type source_type, const char *to, const char *from, const char *content_type, const char *body) is not documented:
 parameter 'source_type'
main/options.c:55: warning: unable to resolve reference to 'Config_ast' for \ref command
include/asterisk/doxyref.h:315: warning: unable to resolve reference to 'Config_cdr' for \ref command
include/asterisk/json.h:855: warning: Unsupported xml/html tag <string> found
include/asterisk/core_unreal.h:98: warning: Found unknown command '@context'
{code}More than 300 warnings spread over more than 100 files. Most of the warnings were about using {{\return}} or {{\retval}} on void functions. This was forbidden and creates a warning since Doxygen [1.8.16 …|https://github.com/doxygen/doxygen/commit/2428c5a]
Comments:By: Asterisk Team (asteriskteam) 2021-11-19 10:14:40.191-0600

Thanks for creating a report! The issue has entered the triage process. That means the issue will wait in this status until a Bug Marshal has an opportunity to review the issue. Once the issue has been reviewed you will receive comments regarding the next steps towards resolution. Please note that log messages and other files should not be sent to the Sangoma Asterisk Team unless explicitly asked for. All files should be placed on this issue in a sanitized fashion as needed.

A good first step is for you to review the [Asterisk Issue Guidelines|https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines] if you haven't already. The guidelines detail what is expected from an Asterisk issue report.

Then, if you are submitting a patch, please review the [Patch Contribution Process|https://wiki.asterisk.org/wiki/display/AST/Patch+Contribution+Process].

Please note that once your issue enters an open state it has been accepted. As Asterisk is an open source project there is no guarantee or timeframe on when your issue will be looked into. If you need expedient resolution you will need to find and pay a suitable developer. Asking for an update on your issue will not yield any progress on it and will not result in a response. All updates are posted to the issue when they occur.

Please note that by submitting data, code, or documentation to Sangoma through JIRA, you accept the Terms of Use present at [https://www.asterisk.org/terms-of-use/|https://www.asterisk.org/terms-of-use/].
By: Friendly Automation (friendly-automation) 2021-12-02 15:00:39.154-0600

Change 17515 merged by Friendly Automation:
main: Fix for Doxygen.

[https://gerrit.asterisk.org/c/asterisk/+/17515|https://gerrit.asterisk.org/c/asterisk/+/17515]
By: Friendly Automation (friendly-automation) 2021-12-02 15:02:11.815-0600

Change 17514 merged by Friendly Automation:
main: Fix for Doxygen.

[https://gerrit.asterisk.org/c/asterisk/+/17514|https://gerrit.asterisk.org/c/asterisk/+/17514]
By: Friendly Automation (friendly-automation) 2021-12-02 15:02:48.962-0600

Change 17562 merged by Friendly Automation:
main: Fix for Doxygen.

[https://gerrit.asterisk.org/c/asterisk/+/17562|https://gerrit.asterisk.org/c/asterisk/+/17562]
By: Friendly Automation (friendly-automation) 2021-12-02 15:03:19.366-0600

Change 17561 merged by Friendly Automation:
main: Fix for Doxygen.

[https://gerrit.asterisk.org/c/asterisk/+/17561|https://gerrit.asterisk.org/c/asterisk/+/17561]