[asterisk-bugs] [JIRA] (ASTERISK-29763) main: Fix for Doxygen
Joshua C. Colp (JIRA)
noreply at issues.asterisk.org
Fri Nov 19 10:21:50 CST 2021
[ https://issues.asterisk.org/jira/browse/ASTERISK-29763?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Work on ASTERISK-29763 started by Alexander Traud.
> main: Fix for Doxygen
> ---------------------
>
> Key: ASTERISK-29763
> URL: https://issues.asterisk.org/jira/browse/ASTERISK-29763
> Project: Asterisk
> Issue Type: Bug
> Security Level: None
> Components: Core/General, Documentation
> Affects Versions: 16.22.0, 18.8.0, 19.0.0
> Reporter: Alexander Traud
> Assignee: Alexander Traud
> Severity: Trivial
>
> 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]
--
This message was sent by Atlassian JIRA
(v6.2#6252)
More information about the asterisk-bugs
mailing list