[asterisk-bugs] [JIRA] (ASTERISK-29755) frame: Fix for Doxygen

[Joshua C. Colp (JIRA)]

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

Joshua C. Colp updated ASTERISK-29755:
--------------------------------------

    Assignee: Alexander Traud

> frame: Fix for Doxygen
> ----------------------
>
>                 Key: ASTERISK-29755
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-29755
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: . I did not set the category correctly.
>    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}
> include/asterisk/frame.h:549: warning: argument 'source' of command @param is not found in the argument list of ast_frame_free(struct ast_frame *fr, int cache)
> include/asterisk/frame.h:549: warning: argument 'source' of command @param is not found in the argument list of ast_frame_free(struct ast_frame *fr, int cache)
> main/audiohook.c:594: warning: documented empty return type of ast_audiohook_detach_list
> include/asterisk/audiohook.h:157: warning: argument 'direction' of command @param is not found in the argument list of ast_audiohook_read_frame_all(struct ast_audiohook *audiohook, size_t samples, struct ast_format *format, struct ast_frame **read_frame, struct ast_frame **write_frame)
> include/asterisk/audiohook.h:241: warning: argument 'audiohook' of command @param is not found in the argument list of ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list)
> main/audiohook.c:1112: warning: The following parameter of ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list) is not documented:
>   parameter 'audiohook_list'
> main/audiohook.c:1241: warning: documented empty return type of audiohook_volume_destroy
> include/asterisk/audiohook.h:186: warning: documented empty return type of ast_audiohook_detach_list
> include/asterisk/audiohook.h:224: warning: argument 'chan' from the argument list of ast_audiohook_detach_source has multiple @param documentation sections
> include/asterisk/audiohook.h:224: warning: argument 'source' from the argument list of ast_audiohook_detach_source has multiple @param documentation sections
> main/audiohook.c:102: warning: argument 'init' of command @param is not found in the argument list of ast_audiohook_init(struct ast_audiohook *audiohook, enum ast_audiohook_type type, const char *source, enum ast_audiohook_init_flags init_flags)
> include/asterisk/audiohook.h:132: warning: argument 'audiohook' from the argument list of ast_audiohook_init has multiple @param documentation sections
> include/asterisk/audiohook.h:132: warning: argument 'type' from the argument list of ast_audiohook_init has multiple @param documentation sections
> include/asterisk/audiohook.h:132: warning: argument 'source' from the argument list of ast_audiohook_init has multiple @param documentation sections
> include/asterisk/audiohook.h:155: warning: argument 'audiohook' from the argument list of ast_audiohook_read_frame has multiple @param documentation sections
> include/asterisk/audiohook.h:155: warning: argument 'samples' from the argument list of ast_audiohook_read_frame has multiple @param documentation sections
> include/asterisk/audiohook.h:155: warning: argument 'direction' from the argument list of ast_audiohook_read_frame has multiple @param documentation sections
> include/asterisk/audiohook.h:155: warning: argument 'format' from the argument list of ast_audiohook_read_frame has multiple @param documentation sections
> include/asterisk/audiohook.h:157: warning: argument 'ast_format' of command @param is not found in the argument list of ast_audiohook_read_frame_all(struct ast_audiohook *audiohook, size_t samples, struct ast_format *format, struct ast_frame **read_frame, struct ast_frame **write_frame)
> include/asterisk/audiohook.h:157: warning: argument 'direction' of command @param is not found in the argument list of ast_audiohook_read_frame_all(struct ast_audiohook *audiohook, size_t samples, struct ast_format *format, struct ast_frame **read_frame, struct ast_frame **write_frame)
> include/asterisk/audiohook.h:157: warning: argument 'direction' of command @param is not found in the argument list of ast_audiohook_read_frame_all(struct ast_audiohook *audiohook, size_t samples, struct ast_format *format, struct ast_frame **read_frame, struct ast_frame **write_frame)
> include/asterisk/audiohook.h:166: warning: argument 'audiohook' from the argument list of ast_audiohook_read_frame_all has multiple @param documentation sections
> include/asterisk/audiohook.h:166: warning: argument 'samples' from the argument list of ast_audiohook_read_frame_all has multiple @param documentation sections
> include/asterisk/audiohook.h:166: warning: argument 'read_frame' from the argument list of ast_audiohook_read_frame_all has multiple @param documentation sections
> include/asterisk/audiohook.h:166: warning: argument 'write_frame' from the argument list of ast_audiohook_read_frame_all has multiple @param documentation sections
> include/asterisk/audiohook.h:339: warning: argument 'chan' from the argument list of ast_audiohook_set_mute has multiple @param documentation sections
> include/asterisk/audiohook.h:339: warning: argument 'source' from the argument list of ast_audiohook_set_mute has multiple @param documentation sections
> include/asterisk/audiohook.h:339: warning: argument 'flag' from the argument list of ast_audiohook_set_mute has multiple @param documentation sections
> include/asterisk/audiohook.h:339: warning: argument 'clear' from the argument list of ast_audiohook_set_mute has multiple @param documentation sections
> include/asterisk/audiohook.h:263: warning: argument 'audiohook' from the argument list of ast_audiohook_update_status has multiple @param documentation sections
> include/asterisk/audiohook.h:329: warning: argument 'chan' from the argument list of ast_audiohook_volume_adjust has multiple @param documentation sections
> include/asterisk/audiohook.h:329: warning: argument 'direction' from the argument list of ast_audiohook_volume_adjust has multiple @param documentation sections
> include/asterisk/audiohook.h:329: warning: argument 'volume' from the argument list of ast_audiohook_volume_adjust has multiple @param documentation sections
> include/asterisk/audiohook.h:319: warning: argument 'chan' from the argument list of ast_audiohook_volume_get has multiple @param documentation sections
> include/asterisk/audiohook.h:319: warning: argument 'direction' from the argument list of ast_audiohook_volume_get has multiple @param documentation sections
> include/asterisk/audiohook.h:310: warning: argument 'chan' from the argument list of ast_audiohook_volume_set has multiple @param documentation sections
> include/asterisk/audiohook.h:310: warning: argument 'direction' from the argument list of ast_audiohook_volume_set has multiple @param documentation sections
> include/asterisk/audiohook.h:310: warning: argument 'volume' from the argument list of ast_audiohook_volume_set has multiple @param documentation sections
> include/asterisk/audiohook.h:241: warning: argument 'audiohook' of command @param is not found in the argument list of ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list)
> include/asterisk/audiohook.h:245: warning: The following parameter of ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list) is not documented:
>   parameter 'audiohook_list'
> main/framehook.c:132: warning: return value 'On' of ast_framehook_attach has multiple documentation sections
> main/framehook.c:287: warning: The following parameter of ast_framehook_list_contains_no_active_of_type(struct ast_framehook_list *framehooks, enum ast_frame_type type) is not documented:
>   parameter 'type'
> include/asterisk/framehook.h:216: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_chan_fixup_callback(void *data, int framehook_id, struct ast_channel *old_chan, struct ast_channel *new_chan)
> include/asterisk/framehook.h:216: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_chan_fixup_callback(void *data, int framehook_id, struct ast_channel *old_chan, struct ast_channel *new_chan)
> include/asterisk/framehook.h:216: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_chan_fixup_callback(void *data, int framehook_id, struct ast_channel *old_chan, struct ast_channel *new_chan)
> include/asterisk/framehook.h:216: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_chan_fixup_callback(void *data, int framehook_id, struct ast_channel *old_chan, struct ast_channel *new_chan)
> include/asterisk/framehook.h:203: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_consume_callback(void *data, enum ast_frame_type type)
> include/asterisk/framehook.h:203: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_consume_callback(void *data, enum ast_frame_type type)
> include/asterisk/framehook.h:191: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_destroy_callback(void *data)
> include/asterisk/framehook.h:159: warning: argument 'channel' of command @param is not found in the argument list of ast_framehook_event_callback(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data)
> include/asterisk/framehook.h:159: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_event_callback(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data)
> include/asterisk/framehook.h:159: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_event_callback(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data)
> include/asterisk/framehook.h:159: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_event_callback(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data)
> include/asterisk/framehook.h:159: warning: argument 'The' of command @param is not found in the argument list of ast_framehook_event_callback(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data)
> include/asterisk/framehook.h:1: warning: The following parameter of ast_framehook_event_callback(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data) is not documented:
>   parameter 'chan'
> include/asterisk/framehook.h:274: warning: return value 'On' of ast_framehook_attach has multiple documentation sections
> include/asterisk/framehook.h:390: warning: The following parameter of ast_framehook_list_contains_no_active_of_type(struct ast_framehook_list *framehooks, enum ast_frame_type type) is not documented:
>   parameter 'type'
> {code}



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