[asterisk-bugs] [JIRA] (ASTERISK-29741) tests: Fix for Doxygen

[Joshua C. Colp (JIRA)]

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

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

    Status: Open  (was: Triage)

> tests: Fix for Doxygen
> ----------------------
>
>                 Key: ASTERISK-29741
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-29741
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Documentation, Tests/General
>    Affects Versions: 16.22.0, 18.8.0, 19.0.0
>            Reporter: 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}
> tests/test_voicemail_api.c:289: warning: End of list marker found without any preceding list items
> tests/test_devicestate.c:243: warning: unable to resolve reference to 'result_states' for \ref command
> tests/test_dns_naptr.c:47: warning: argument 'string' of command @param is not found in the argument list of generate_naptr_record(void *dns_record, char *buf)
> tests/test_dns_naptr.c:58: warning: The following parameter of generate_naptr_record(void *dns_record, char *buf) is not documented:
>   parameter 'dns_record'
> tests/test_message.c:58: warning: unable to resolve reference to 'test_message_handler' for \ref command
> tests/test_voicemail_api.c:411: warning: argument 'snapshot' of command @param is not found in the argument list of test_vm_api_create_voicemail_folder(const char *folder_path)
> tests/test_voicemail_api.c:419: warning: The following parameter of test_vm_api_create_voicemail_folder(const char *folder_path) is not documented:
>   parameter 'folder_path'
> tests/test_voicemail_api.c:618: warning: Found unknown command '@default'
> tests/test_voicemail_api.c:619: warning: Found unknown command '@default'
> tests/test_voicemail_api.c:620: warning: Found unknown command '@default'
> tests/test_voicemail_api.c:621: warning: Found unknown command '@default'
> {code}
> The most interesting warning is the first one: In test_voicemail_api.c, there are three dots at the (very) end of the line. Doxygen thinks that is part of a list. Although caused by commit [e47d3db|https://github.com/asterisk/asterisk/commit/e47d3db], I have no idea how something like that can happen. It happened nowhere in the source again.



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