[asterisk-bugs] [JIRA] (ASTERISK-29749) res_xmpp: Fix for Doxygen

[Joshua C. Colp (JIRA)]

     [ https://issues.asterisk.org/jira/browse/ASTERISK-29749?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Work on ASTERISK-29749 started by Alexander Traud.

> res_xmpp: Fix for Doxygen
> -------------------------
>
>                 Key: ASTERISK-29749
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-29749
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Documentation, Resources/res_xmpp
>    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}
> res/res_xmpp.c:1933: warning: argument 'channel' of command @param is not found in the argument list of acf_jabberreceive_read(struct ast_channel *chan, const char *name, char *data, char *buf, size_t buflen)
> res/res_xmpp.c:1941: warning: The following parameters of acf_jabberreceive_read(struct ast_channel *chan, const char *name, char *data, char *buf, size_t buflen) are not documented:
>   parameter 'chan'
>   parameter 'name'
>   parameter 'buf'
>   parameter 'buflen'
> res/res_xmpp.c:1667: warning: argument 'channel' of command @param is not found in the argument list of acf_jabberstatus_read(struct ast_channel *chan, const char *name, char *data, char *buf, size_t buflen)
> res/res_xmpp.c:1675: warning: The following parameters of acf_jabberstatus_read(struct ast_channel *chan, const char *name, char *data, char *buf, size_t buflen) are not documented:
>   parameter 'chan'
>   parameter 'name'
>   parameter 'buf'
>   parameter 'buflen'
> res/res_xmpp.c:1593: warning: documented empty return type of xmpp_init_event_distribution
> res/res_xmpp.c:1076: warning: The following parameter of xmpp_pubsub_build_publish_skeleton(struct ast_xmpp_client *client, const char *node, const char *event_type, unsigned int cachable) is not documented:
>   parameter 'cachable'
> res/res_xmpp.c:1161: warning: documented empty return type of xmpp_pubsub_create_affiliations
> res/res_xmpp.c:1247: warning: documented empty return type of xmpp_pubsub_create_collection
> res/res_xmpp.c:1260: warning: documented empty return type of xmpp_pubsub_create_leaf
> res/res_xmpp.c:1199: warning: documented empty return type of xmpp_pubsub_create_node
> res/res_xmpp.c:1364: warning: argument 'ast_event' of command @param is not found in the argument list of xmpp_pubsub_devstate_cb(void *data, struct stasis_subscription *sub, struct stasis_message *msg)
> res/res_xmpp.c:1369: warning: The following parameters of xmpp_pubsub_devstate_cb(void *data, struct stasis_subscription *sub, struct stasis_message *msg) are not documented:
>   parameter 'sub'
>   parameter 'msg'
> res/res_xmpp.c:1369: warning: documented empty return type of xmpp_pubsub_devstate_cb
> res/res_xmpp.c:1336: warning: argument 'ast_event' of command @param is not found in the argument list of xmpp_pubsub_mwi_cb(void *data, struct stasis_subscription *sub, struct stasis_message *msg)
> res/res_xmpp.c:1341: warning: The following parameters of xmpp_pubsub_mwi_cb(void *data, struct stasis_subscription *sub, struct stasis_message *msg) are not documented:
>   parameter 'sub'
>   parameter 'msg'
> res/res_xmpp.c:1341: warning: documented empty return type of xmpp_pubsub_mwi_cb
> res/res_xmpp.c:1305: warning: The following parameter of xmpp_pubsub_publish_device_state(struct ast_xmpp_client *client, const char *device, const char *device_state, unsigned int cachable) is not documented:
>   parameter 'cachable'
> res/res_xmpp.c:1305: warning: documented empty return type of xmpp_pubsub_publish_device_state
> res/res_xmpp.c:1274: warning: documented empty return type of xmpp_pubsub_publish_mwi
> res/res_xmpp.c:4034: warning: documented empty return type of xmpp_pubsub_request_nodes
> res/res_xmpp.c:1419: warning: documented empty return type of xmpp_pubsub_subscribe
> res/res_xmpp.c:1393: warning: documented empty return type of xmpp_pubsub_unsubscribe
> res/res_xmpp.c:40: warning: included file jabber.conf.sample is not found. Check your EXAMPLE_PATH
> {code}



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