Summary:	ASTERISK-29750: stasis: Fix for Doxygen
Reporter:	Alexander Traud (traud)	Labels:
Date Opened:	2021-11-16 10:32:29.000-0600	Date Closed:	2021-11-18 13:26:00.000-0600
Priority:	Trivial	Regression?
Status:	Closed/Complete	Components:	Core/Stasis Resources/res_stasis_recording Resources/res_stasis_snoop
Versions:	16.22.0 18.8.0 19.0.0	Frequency of Occurrence
Related Issues:
Environment:		Attachments:
Description:	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.
Comments:	By: Asterisk Team (asteriskteam) 2021-11-16 10:32:30.705-0600 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/]. By: Kevin Harwell (kharwell) 2021-11-16 11:13:48.668-0600 [~traud] Do you know how many more of these (doxygen patches) you'll be submitting? If many more could you combine the rest into one patch? By: Friendly Automation (friendly-automation) 2021-11-18 13:26:01.357-0600 Change 17491 merged by Friendly Automation: stasis: Fix for Doxygen. [https://gerrit.asterisk.org/c/asterisk/+/17491|https://gerrit.asterisk.org/c/asterisk/+/17491] By: Friendly Automation (friendly-automation) 2021-11-18 13:44:35.589-0600 Change 17490 merged by Friendly Automation: stasis: Fix for Doxygen. [https://gerrit.asterisk.org/c/asterisk/+/17490|https://gerrit.asterisk.org/c/asterisk/+/17490] By: Friendly Automation (friendly-automation) 2021-11-18 14:46:48.675-0600 Change 17477 merged by Kevin Harwell: stasis: Fix for Doxygen. [https://gerrit.asterisk.org/c/asterisk/+/17477|https://gerrit.asterisk.org/c/asterisk/+/17477] By: Friendly Automation (friendly-automation) 2021-11-18 14:47:05.008-0600 Change 17478 merged by Kevin Harwell: stasis: Fix for Doxygen. [https://gerrit.asterisk.org/c/asterisk/+/17478|https://gerrit.asterisk.org/c/asterisk/+/17478]