[asterisk-bugs] [JIRA] (ASTERISK-29762) channels: Fix for Doxygen

[Friendly Automation (JIRA)]

    [ https://issues.asterisk.org/jira/browse/ASTERISK-29762?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=257098#comment-257098 ] 

Friendly Automation commented on ASTERISK-29762:
------------------------------------------------

Change 17558 merged by Friendly Automation:
channels: Fix for Doxygen.

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

> channels: Fix for Doxygen
> -------------------------
>
>                 Key: ASTERISK-29762
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-29762
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Channels/chan_dahdi, Channels/chan_sip/General, Documentation
>    Affects Versions: 16.22.0, 18.8.0, 19.0.0
>            Reporter: Alexander Traud
>            Assignee: Alexander Traud
>            Severity: Trivial
>
> If all {{WARN_}} are enabled in the file {{doc/asterisk-ng-doxygen.in}}, the following appears in the file {{doxygen.log}}:
> {code}
> channels/chan_dahdi.c:1805: warning: documented empty return type of dahdi_ami_channel_event
> channels/chan_dahdi.c:5336: warning: documented empty return type of dahdi_iflist_extract
> channels/chan_dahdi.c:5286: warning: documented empty return type of dahdi_iflist_insert
> channels/chan_dahdi.c:3469: warning: documented empty return type of dahdi_lock_sub_owner
> channels/chan_dahdi.c:9148: warning: The following parameters of dahdi_new_callid_clean(struct dahdi_pvt *i, int state, int startpbx, int idx, int law, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, ast_callid callid, int callid_created) are not documented:
>   parameter 'i'
>   parameter 'state'
>   parameter 'startpbx'
>   parameter 'idx'
>   parameter 'law'
>   parameter 'assignedids'
>   parameter 'requestor'
>   parameter 'callid'
> channels/chan_dahdi.c:19342: warning: documented empty return type of deep_copy_dahdi_chan_conf
> channels/chan_dahdi.c:3296: warning: documented empty return type of notify_message
> channels/dahdi/bridge_native_dahdi.c:891: warning: documented empty return type of dahdi_native_unload
> channels/dahdi/bridge_native_dahdi.c:484: warning: documented empty return type of native_request_start
> channels/dahdi/bridge_native_dahdi.c:184: warning: documented empty return type of native_request_stop
> channels/dahdi/bridge_native_dahdi.c:140: warning: documented empty return type of native_stop
> channels/dahdi/bridge_native_dahdi.h:38: warning: documented empty return type of dahdi_native_unload
> {code} {code}
> channels/chan_sip.c:29: warning: unable to resolve link to 'Config_sip' for \link command
> channels/chan_sip.c:2845: warning: argument 'data' of command @param is not found in the argument list of check_message_integrity(struct ast_str **request, struct ast_str **overflow)
> channels/chan_sip.c:3298: warning: documented empty return type of ref_proxy
> channels/chan_sip.c:2923: warning: The following parameters of sip_tcptls_read(struct sip_request *req, struct ast_tcptls_session_instance *tcptls_session, int authenticated, time_t start) are not documented:
>   parameter 'authenticated'
>   parameter 'start'
> channels/sip/config_parser.c:93: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:93: warning: Found unknown command '@host'
> channels/sip/config_parser.c:95: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:100: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:106: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:112: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:120: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:129: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:139: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:93: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:93: warning: Found unknown command '@host'
> channels/sip/config_parser.c:95: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:100: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:106: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:112: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:120: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:129: warning: Found unknown command '@domain'
> channels/sip/config_parser.c:139: warning: Found unknown command '@domain'
> channels/sip/reqresp_parser.c:1684: warning: argument 'option' of command @param is not found in the argument list of parse_sip_options(const char *options, char *unsupported, size_t unsupported_len)
> channels/sip/include/reqresp_parser.h:185: warning: argument 'unsupported' from the argument list of parse_sip_options has multiple @param documentation sections
> channels/sip/route.c:115: warning: documented empty return type of sip_route_copy
> channels/sip/include/route.h:68: warning: Unsupported xml/html tag <brackets> found
> channels/sip/include/route.h:78: warning: documented empty return type of sip_route_copy
> channels/sip/include/route.h:68: warning: Unsupported xml/html tag <brackets> found
> {code}
> Because those changes are small, I combine both in one change about the section {{/channels}}. Not to confuse with the already fixed module {{main/channel}}.



--
This message was sent by Atlassian JIRA
(v6.2#6252)