[asterisk-bugs] [JIRA] (ASTERISK-29763) main: Fix for Doxygen
Asterisk Team (JIRA)
noreply at issues.asterisk.org
Fri Nov 19 10:15:50 CST 2021
[ https://issues.asterisk.org/jira/browse/ASTERISK-29763?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=257103#comment-257103 ]
Asterisk Team commented on ASTERISK-29763:
------------------------------------------
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/].
> 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
> 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.
--
This message was sent by Atlassian JIRA
(v6.2#6252)
More information about the asterisk-bugs
mailing list