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

[Alexander Traud (JIRA)]

Alexander Traud created ASTERISK-29741:
------------------------------------------

             Summary: 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: 19.0.0, 18.8.0, 16.22.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)