[asterisk-bugs] [JIRA] (ASTERISK-29750) stasis: Fix for Doxygen

Asterisk Team (JIRA) noreply at issues.asterisk.org
Thu Dec 2 12:44:37 CST 2021


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

Asterisk Team updated ASTERISK-29750:
-------------------------------------

    Target Release Version/s: 16.23.0

> stasis: Fix for Doxygen
> -----------------------
>
>                 Key: ASTERISK-29750
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-29750
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Core/Stasis, Resources/res_stasis_recording, Resources/res_stasis_snoop
>    Affects Versions: 16.22.0, 18.8.0, 19.0.0
>            Reporter: Alexander Traud
>            Assignee: Alexander Traud
>            Severity: Trivial
>      Target Release: 16.23.0
>
>
> If all {{WARN_}} are enabled in the file {{doc/asterisk-ng-doxygen.in}}, the following appears in the file {{doxygen.log}}:
> {code}
> res/stasis/app.c:915: warning: The following parameter of app_create(const char *name, stasis_app_cb handler, void *data, enum stasis_app_subscription_model subscription_model) is not documented:
>   parameter 'subscription_model'
> res/stasis/app.h:94: warning: argument 'True' of command @param is not found in the argument list of app_is_finished(struct stasis_app *app)
> res/stasis/app.h:94: warning: argument 'False' of command @param is not found in the argument list of app_is_finished(struct stasis_app *app)
> res/stasis/app.h:214: warning: argument 'chan' of command @param is not found in the argument list of app_subscribe_endpoint(struct stasis_app *app, struct ast_endpoint *endpoint)
> res/stasis/app.c:1531: warning: The following parameter of app_subscribe_endpoint(struct stasis_app *app, struct ast_endpoint *endpoint) is not documented:
>   parameter 'endpoint'
> res/stasis/app.h:184: warning: argument 'forwards' of command @param is not found in the argument list of app_unsubscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge)
> res/stasis/app.c:1486: warning: The following parameter of app_unsubscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge) is not documented:
>   parameter 'app'
> res/stasis/app.h:61: warning: The following parameter of app_create(const char *name, stasis_app_cb handler, void *data, enum stasis_app_subscription_model subscription_model) is not documented:
>   parameter 'subscription_model'
> res/stasis/app.h:266: warning: argument 'channel' of command @param is not found in the argument list of app_get_replace_channel_app(struct ast_channel *chan)
> res/stasis/app.h:271: warning: The following parameter of app_get_replace_channel_app(struct ast_channel *chan) is not documented:
>   parameter 'chan'
> res/stasis/app.h:94: warning: argument 'True' of command @param is not found in the argument list of app_is_finished(struct stasis_app *app)
> res/stasis/app.h:94: warning: argument 'False' of command @param is not found in the argument list of app_is_finished(struct stasis_app *app)
> res/stasis/app.h:117: warning: argument 'app' from the argument list of app_send has multiple @param documentation sections
> res/stasis/app.h:117: warning: argument 'message' from the argument list of app_send has multiple @param documentation sections
> res/stasis/app.h:255: warning: argument 'channel' of command @param is not found in the argument list of app_set_replace_channel_app(struct ast_channel *chan, const char *replace_app)
> res/stasis/app.h:261: warning: The following parameter of app_set_replace_channel_app(struct ast_channel *chan, const char *replace_app) is not documented:
>   parameter 'chan'
> res/stasis/app.h:244: warning: argument 'channel' of command @param is not found in the argument list of app_set_replace_channel_snapshot(struct ast_channel *chan, struct ast_channel_snapshot *replace_snapshot)
> res/stasis/app.h:250: warning: The following parameter of app_set_replace_channel_snapshot(struct ast_channel *chan, struct ast_channel_snapshot *replace_snapshot) is not documented:
>   parameter 'chan'
> res/stasis/app.h:214: warning: argument 'chan' of command @param is not found in the argument list of app_subscribe_endpoint(struct stasis_app *app, struct ast_endpoint *endpoint)
> res/stasis/app.h:219: warning: The following parameter of app_subscribe_endpoint(struct stasis_app *app, struct ast_endpoint *endpoint) is not documented:
>   parameter 'endpoint'
> res/stasis/app.h:184: warning: argument 'forwards' of command @param is not found in the argument list of app_unsubscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge)
> res/stasis/app.h:189: warning: The following parameter of app_unsubscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge) is not documented:
>   parameter 'app'
> res/stasis/control.c:1482: warning: documented empty return type of control_flush_queue
> res/stasis/control.h:93: warning: argument 'channel' of command @param is not found in the argument list of control_prestart_dispatch_all(struct stasis_app_control *control, struct ast_channel *chan)
> res/stasis/control.c:1535: warning: The following parameter of control_prestart_dispatch_all(struct stasis_app_control *control, struct ast_channel *chan) is not documented:
>   parameter 'chan'
> include/asterisk/stasis_app.h:841: warning: argument 'mute' of command @param is not found in the argument list of stasis_app_control_inhibit_colp_in_bridge(struct stasis_app_control *control, int inhibit_colp)
> res/stasis/control.c:1476: warning: The following parameter of stasis_app_control_inhibit_colp_in_bridge(struct stasis_app_control *control, int inhibit_colp) is not documented:
>   parameter 'inhibit_colp'
> res/stasis/control.h:51: warning: documented empty return type of control_flush_queue
> res/stasis/control.h:93: warning: argument 'channel' of command @param is not found in the argument list of control_prestart_dispatch_all(struct stasis_app_control *control, struct ast_channel *chan)
> res/stasis/control.h:98: warning: The following parameter of control_prestart_dispatch_all(struct stasis_app_control *control, struct ast_channel *chan) is not documented:
>   parameter 'chan'
> res/stasis/app.h:266: warning: argument 'channel' of command @param is not found in the argument list of app_get_replace_channel_app(struct ast_channel *chan)
> res/res_stasis.c:967: warning: The following parameter of app_get_replace_channel_app(struct ast_channel *chan) is not documented:
>   parameter 'chan'
> res/stasis/app.h:255: warning: argument 'channel' of command @param is not found in the argument list of app_set_replace_channel_app(struct ast_channel *chan, const char *replace_app)
> res/res_stasis.c:931: warning: The following parameter of app_set_replace_channel_app(struct ast_channel *chan, const char *replace_app) is not documented:
>   parameter 'chan'
> res/stasis/app.h:244: warning: argument 'channel' of command @param is not found in the argument list of app_set_replace_channel_snapshot(struct ast_channel *chan, struct ast_channel_snapshot *replace_snapshot)
> res/res_stasis.c:919: warning: The following parameter of app_set_replace_channel_snapshot(struct ast_channel *chan, struct ast_channel_snapshot *replace_snapshot) is not documented:
>   parameter 'chan'
> res/res_stasis.c:861: warning: documented empty return type of stasis_app_bridge_destroy
> res/res_stasis.c:705: warning: The following parameter of stasis_app_bridge_playback_channel_add(struct ast_bridge *bridge, struct ast_channel *chan, struct stasis_app_control *control) is not documented:
>   parameter 'control'
> include/asterisk/stasis_app.h:885: warning: argument 'The' of command @param is not found in the argument list of stasis_app_channel_set_stasis_end_published(struct ast_channel *chan)
> res/res_stasis.c:1287: warning: The following parameter of stasis_app_channel_set_stasis_end_published(struct ast_channel *chan) is not documented:
>   parameter 'chan'
> res/res_stasis.c:1278: warning: documented empty return type of stasis_app_control_flush_queue
> include/asterisk/stasis_app_device_state.h:88: warning: Found unknown command '\returna'
> include/asterisk/stasis_app_playback.h:155: warning: argument 'control' of command @param is not found in the argument list of stasis_app_playback_operation(struct stasis_app_playback *playback, enum stasis_app_playback_media_operation operation)
> res/res_stasis_playback.c:698: warning: The following parameter of stasis_app_playback_operation(struct stasis_app_playback *playback, enum stasis_app_playback_media_operation operation) is not documented:
>   parameter 'operation'
> include/asterisk/stasis_app_playback.h:141: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis_app_recording.h:304: warning: argument 'control' of command @param is not found in the argument list of stasis_app_recording_operation(struct stasis_app_recording *recording, enum stasis_app_recording_media_operation operation)
> res/res_stasis_recording.c:573: warning: The following parameter of stasis_app_recording_operation(struct stasis_app_recording *recording, enum stasis_app_recording_media_operation operation) is not documented:
>   parameter 'operation'
> res/res_stasis_snoop.c:109: warning: Found unknown command '\start'
> res/res_stasis_snoop.c:113: warning: The following parameter of publish_chanspy_message(struct stasis_app_snoop *snoop, int start) is not documented:
>   parameter 'start'
> res/res_stasis_snoop.c:309: warning: The following parameter of stasis_app_control_snoop(struct ast_channel *chan, enum stasis_app_snoop_direction spy, enum stasis_app_snoop_direction whisper, const char *app, const char *app_args, const char *snoop_id) is not documented:
>   parameter 'snoop_id'
> res/res_stasis_test.c:191: warning: The following parameter of stasis_message_sink_wait_for(struct stasis_message_sink *sink, int start, stasis_wait_cb cmp_cb, const void *data, int timeout_millis) is not documented:
>   parameter 'data'
> res/stasis/messaging.h:57: warning: argument 'message_received_cb' of command @param is not found in the argument list of messaging_app_subscribe_endpoint(const char *app_name, struct ast_endpoint *endpoint, message_received_cb callback, void *pvt)
> res/stasis/messaging.c:493: warning: The following parameter of messaging_app_subscribe_endpoint(const char *app_name, struct ast_endpoint *endpoint, message_received_cb callback, void *pvt) is not documented:
>   parameter 'callback'
> res/stasis/messaging.c:423: warning: documented empty return type of messaging_app_unsubscribe_endpoint
> res/stasis/messaging.h:57: warning: argument 'message_received_cb' of command @param is not found in the argument list of messaging_app_subscribe_endpoint(const char *app_name, struct ast_endpoint *endpoint, message_received_cb callback, void *pvt)
> res/stasis/messaging.h:65: warning: The following parameter of messaging_app_subscribe_endpoint(const char *app_name, struct ast_endpoint *endpoint, message_received_cb callback, void *pvt) is not documented:
>   parameter 'callback'
> res/stasis/messaging.h:52: warning: documented empty return type of messaging_app_unsubscribe_endpoint
> res/stasis/stasis_bridge.c:327: warning: documented empty return type of bridge_stasis_init
> res/stasis/stasis_bridge.c:284: warning: documented empty return type of bridge_stasis_pull
> res/stasis/stasis_bridge.h:67: warning: documented empty return type of bridge_stasis_init
> include/asterisk/stasis_bridges.h:271: warning: argument 'bridge' of command @param is not found in the argument list of ast_blind_transfer_message_create(int is_external, struct ast_channel *transferer, const char *exten, const char *context)
> main/stasis_bridges.c:500: warning: The following parameters of ast_bridge_blob_create(struct stasis_message_type *type, struct ast_bridge *bridge, struct ast_channel *chan, struct ast_json *blob) are not documented:
>   parameter 'type'
>   parameter 'chan'
> include/asterisk/stasis_bridges.h:170: warning: argument 'channel_snapshot' of command @param is not found in the argument list of ast_bridge_blob_create_from_snapshots(struct stasis_message_type *type, struct ast_bridge_snapshot *bridge_snapshot, struct ast_channel_snapshot *chan_snapshot, struct ast_json *blob)
> main/stasis_bridges.c:546: warning: The following parameters of ast_bridge_blob_create_from_snapshots(struct stasis_message_type *type, struct ast_bridge_snapshot *bridge_snapshot, struct ast_channel_snapshot *chan_snapshot, struct ast_json *blob) are not documented:
>   parameter 'type'
>   parameter 'chan_snapshot'
> include/asterisk/stasis_bridges.h:286: warning: argument 'is_external' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'result' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'to_transferee' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'context' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'exten' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'transferee_channel' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'replace_channel' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> main/stasis_bridges.c:953: warning: The following parameter of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message) is not documented:
>   parameter 'transfer_message'
> main/stasis_bridges.c:752: warning: argument 'pair' of command @param is not found in the argument list of bridge_channel_snapshot_pair_init(struct ast_channel *channel, struct ast_bridge *bridge, struct ast_bridge_channel_snapshot_pair *snapshot_pair)
> main/stasis_bridges.c:760: warning: The following parameters of bridge_channel_snapshot_pair_init(struct ast_channel *channel, struct ast_bridge *bridge, struct ast_bridge_channel_snapshot_pair *snapshot_pair) are not documented:
>   parameter 'channel'
>   parameter 'bridge'
> include/asterisk/stasis_bridges.h:134: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_bridges.h:142: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_bridges.h:271: warning: argument 'bridge' of command @param is not found in the argument list of ast_blind_transfer_message_create(int is_external, struct ast_channel *transferer, const char *exten, const char *context)
> include/asterisk/stasis_bridges.h:164: warning: The following parameters of ast_bridge_blob_create(struct stasis_message_type *type, struct ast_bridge *bridge, struct ast_channel *chan, struct ast_json *blob) are not documented:
>   parameter 'type'
>   parameter 'chan'
> include/asterisk/stasis_bridges.h:170: warning: argument 'channel_snapshot' of command @param is not found in the argument list of ast_bridge_blob_create_from_snapshots(struct stasis_message_type *type, struct ast_bridge_snapshot *bridge_snapshot, struct ast_channel_snapshot *chan_snapshot, struct ast_json *blob)
> include/asterisk/stasis_bridges.h:187: warning: The following parameters of ast_bridge_blob_create_from_snapshots(struct stasis_message_type *type, struct ast_bridge_snapshot *bridge_snapshot, struct ast_channel_snapshot *chan_snapshot, struct ast_json *blob) are not documented:
>   parameter 'type'
>   parameter 'chan_snapshot'
> include/asterisk/stasis_bridges.h:286: warning: argument 'is_external' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'result' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'to_transferee' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'context' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'exten' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'transferee_channel' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:286: warning: argument 'replace_channel' of command @param is not found in the argument list of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message)
> include/asterisk/stasis_bridges.h:299: warning: The following parameter of ast_bridge_publish_blind_transfer(struct ast_blind_transfer_message *transfer_message) is not documented:
>   parameter 'transfer_message'
> include/asterisk/stasis_bridges.h:134: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_bridges.h:136: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_bridges.h:142: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_bridges.h:144: warning: unable to resolve reference to 'channel' for \ref command
> main/stasis_cache.c:629: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1119: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1145: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1319: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1345: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1333: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1269: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1307: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1293: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis_channels.h:469: warning: unable to resolve reference to 'ast_channel_varset' for \ref command
> include/asterisk/stasis_channels.h:469: warning: unable to resolve reference to 'ast_channel_varset' for \ref command
> include/asterisk/stasis_internal.h:63: warning: The following parameters of internal_stasis_subscribe(struct stasis_topic *topic, stasis_subscription_cb callback, void *data, int needs_mailbox, int use_thread_pool, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> include/asterisk/stasis.h:407: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:419: warning: unexpected token in comment block while parsing the argument of command retval
> main/stasis_message_router.c:246: warning: The following parameters of __stasis_message_router_create(struct stasis_topic *topic, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> main/stasis_message_router.c:252: warning: The following parameters of __stasis_message_router_create_pool(struct stasis_topic *topic, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> include/asterisk/stasis_message_router.h:58: warning: The following parameters of __stasis_message_router_create(struct stasis_topic *topic, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> include/asterisk/stasis_message_router.h:75: warning: The following parameters of __stasis_message_router_create_pool(struct stasis_topic *topic, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> main/stasis_state.c:260: warning: argument 'manager' of command @param is not found in the argument list of state_find_or_add(mgr, top, id)
> main/stasis_state.c:260: warning: argument 'state_topic' of command @param is not found in the argument list of state_find_or_add(mgr, top, id)
> main/stasis_state.c:270: warning: The following parameters of state_find_or_add(mgr, top, id) are not documented:
>   parameter 'mgr'
>   parameter 'top'
> main/stasis_state.c:167: warning: The following parameters of state_alloc(struct stasis_state_manager *manager, struct stasis_topic *state_topic, const char *id, const char *file, int line, const char *func) are not documented:
>   parameter 'file'
>   parameter 'line'
>   parameter 'func'
> include/asterisk/stasis_system.h:40: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis_system.h:50: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis_system.h:40: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis_test.h:108: warning: The following parameter of stasis_message_sink_wait_for(struct stasis_message_sink *sink, int start, stasis_wait_cb cmp_cb, const void *data, int timeout_millis) is not documented:
>   parameter 'data'
> res/stasis_recording/stored.c:83: warning: argument 'fail' of command @param is not found in the argument list of split_path(const char *path, char **dir, char **file)
> res/stasis_recording/stored.c:92: warning: The following parameter of split_path(const char *path, char **dir, char **file) is not documented:
>   parameter 'file'
> include/asterisk/stasis.h:68: warning: unable to resolve reference to 'stasis_subscriber' for \ref command
> include/asterisk/stasis.h:109: warning: unable to resolve reference to 'stasis_caching_topics' for \ref command
> main/devicestate.c:102: warning: unable to resolve reference to 'AstENUM' for \ref command
> main/stasis.c:253: warning: unable to resolve reference to 'dispatch' for \ref command
> include/asterisk/stasis_channels.h:469: warning: unable to resolve reference to 'ast_channel_varset' for \ref command
> include/asterisk/stasis_channels.h:405: warning: documented empty return type of ast_channel_publish_blob
> include/asterisk/stasis_channels.h:422: warning: documented empty return type of ast_channel_publish_cached_blob
> include/asterisk/stasis_channels.h:469: warning: unable to resolve reference to 'ast_channel_varset' for \ref command
> include/asterisk/stasis_channels.h:238: warning: argument 'unique_id' of command @param is not found in the argument list of ast_channel_snapshot_get_latest(const char *uniqueid)
> include/asterisk/stasis_channels.h:247: warning: The following parameter of ast_channel_snapshot_get_latest(const char *uniqueid) is not documented:
>   parameter 'uniqueid'
> include/asterisk/stasis_channels.h:336: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1405: warning: documented empty return type of ast_multi_object_blob_add
> include/asterisk/stasis.h:1422: warning: documented empty return type of ast_multi_object_blob_single_channel_publish
> include/asterisk/stasis_bridges.h:134: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_bridges.h:142: warning: unable to resolve reference to 'channel' for \ref command
> include/asterisk/stasis_channels.h:469: warning: unable to resolve reference to 'ast_channel_varset' for \ref command
> include/asterisk/stasis_channels.h:469: warning: unable to resolve reference to 'ast_channel_varset' for \ref command
> main/stasis.c:944: warning: The following parameters of __stasis_subscribe(struct stasis_topic *topic, stasis_subscription_cb callback, void *data, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> main/stasis.c:955: warning: The following parameters of __stasis_subscribe_pool(struct stasis_topic *topic, stasis_subscription_cb callback, void *data, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> main/stasis.c:858: warning: The following parameters of internal_stasis_subscribe(struct stasis_topic *topic, stasis_subscription_cb callback, void *data, int needs_mailbox, int use_thread_pool, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> include/asterisk/stasis.h:599: warning: unable to resolve reference to 'stasis_subpscription' for \ref command
> include/asterisk/stasis.h:517: warning: Unsupported xml/html tag <subsystem> found
> include/asterisk/stasis.h:517: warning: Unsupported xml/html tag <functionality> found
> include/asterisk/stasis.h:517: warning: Unsupported xml/html tag <object> found
> include/asterisk/stasis.h:934: warning: Unsupported xml/html tag <pool_topic_name> found
> include/asterisk/stasis.h:934: warning: Unsupported xml/html tag <topic_name> found
> include/asterisk/stasis.h:934: warning: Unsupported xml/html tag <topic_name> found
> main/stasis.c:751: warning: argument 'topic' of command @param is not found in the argument list of subscription_invoke(struct stasis_subscription *sub, struct stasis_message *message)
> include/asterisk/stasis.h:615: warning: The following parameter of stasis_subscription_cb(void *data, struct stasis_subscription *sub, struct stasis_message *message) is not documented:
>   parameter 'sub'
> include/asterisk/stasis.h:650: warning: The following parameters of __stasis_subscribe(struct stasis_topic *topic, stasis_subscription_cb callback, void *data, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> include/asterisk/stasis.h:680: warning: The following parameters of __stasis_subscribe_pool(struct stasis_topic *topic, stasis_subscription_cb callback, void *data, const char *file, int lineno, const char *func) are not documented:
>   parameter 'file'
>   parameter 'lineno'
>   parameter 'func'
> include/asterisk/stasis.h:1119: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1145: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1319: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1345: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1333: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1269: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1307: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:1293: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:407: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:419: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis.h:599: warning: unable to resolve reference to 'stasis_subpscription' for \ref command
> include/asterisk/stasis.h:517: warning: Unsupported xml/html tag <subsystem> found
> include/asterisk/stasis.h:517: warning: Unsupported xml/html tag <functionality> found
> include/asterisk/stasis.h:517: warning: Unsupported xml/html tag <object> found
> include/asterisk/stasis.h:934: warning: Unsupported xml/html tag <pool_topic_name> found
> include/asterisk/stasis.h:934: warning: Unsupported xml/html tag <topic_name> found
> include/asterisk/stasis.h:934: warning: Unsupported xml/html tag <topic_name> found
> include/asterisk/stasis_app.h:873: warning: documented empty return type of stasis_app_bridge_destroy
> include/asterisk/stasis_app.h:761: warning: The following parameter of stasis_app_bridge_playback_channel_add(struct ast_bridge *bridge, struct ast_channel *chan, struct stasis_app_control *control) is not documented:
>   parameter 'control'
> include/asterisk/stasis_app.h:885: warning: argument 'The' of command @param is not found in the argument list of stasis_app_channel_set_stasis_end_published(struct ast_channel *chan)
> include/asterisk/stasis_app.h:887: warning: The following parameter of stasis_app_channel_set_stasis_end_published(struct ast_channel *chan) is not documented:
>   parameter 'chan'
> include/asterisk/stasis_app.h:458: warning: documented empty return type of stasis_app_control_flush_queue
> include/asterisk/stasis_app.h:841: warning: argument 'mute' of command @param is not found in the argument list of stasis_app_control_inhibit_colp_in_bridge(struct stasis_app_control *control, int inhibit_colp)
> include/asterisk/stasis_app.h:847: warning: The following parameter of stasis_app_control_inhibit_colp_in_bridge(struct stasis_app_control *control, int inhibit_colp) is not documented:
>   parameter 'inhibit_colp'
> include/asterisk/stasis_app_device_state.h:88: warning: Found unknown command '\returna'
> include/asterisk/stasis_app_playback.h:155: warning: argument 'control' of command @param is not found in the argument list of stasis_app_playback_operation(struct stasis_app_playback *playback, enum stasis_app_playback_media_operation operation)
> include/asterisk/stasis_app_playback.h:144: warning: The following parameter of stasis_app_playback_operation(struct stasis_app_playback *playback, enum stasis_app_playback_media_operation operation) is not documented:
>   parameter 'operation'
> include/asterisk/stasis_app_playback.h:141: warning: unexpected token in comment block while parsing the argument of command retval
> include/asterisk/stasis_app_recording.h:304: warning: argument 'control' of command @param is not found in the argument list of stasis_app_recording_operation(struct stasis_app_recording *recording, enum stasis_app_recording_media_operation operation)
> include/asterisk/stasis_app_recording.h:286: warning: The following parameter of stasis_app_recording_operation(struct stasis_app_recording *recording, enum stasis_app_recording_media_operation operation) is not documented:
>   parameter 'operation'
> include/asterisk/stasis_app_snoop.h:56: warning: The following parameter of stasis_app_control_snoop(struct ast_channel *chan, enum stasis_app_snoop_direction spy, enum stasis_app_snoop_direction whisper, const char *app, const char *app_args, const char *snoop_id) is not documented:
>   parameter 'snoop_id'
> {code}
> Lesson to learn here: Difference between \return and \retval. The latter has an argument which is displayed with a typewriter font like in a Terminal.



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



More information about the asterisk-bugs mailing list