tests: Fix for Doxygen.

ASTERISK-29741

Change-Id: I012d72b237bda2ef2d0f86307dfc6dc7add4b54b

tests/test_devicestate.c

@@ -240,7 +240,7 @@ static AST_VECTOR(, enum ast_device_state) result_states;
 /*! \brief The current device state for our device state provider */
 static enum ast_device_state current_device_state;
 
-/*! \brief Clear out all recorded device states in \ref result_states */
+/*! \brief Clear out all recorded device states in \p result_states */
 static void clear_result_states(void)
 {
 	ast_mutex_lock(&update_lock);

tests/test_dns_naptr.c

@@ -51,7 +51,7 @@ struct naptr_record {
  * the data ourselves and have sized the buffer to be way larger
  * than necessary for the tests.
  *
- * \param string The NAPTR record to encode
+ * \param dns_record The NAPTR record to encode
  * \param buf The buffer to write the record into
  * \return The number of bytes written to the buffer
  */

tests/test_message.c

@@ -55,7 +55,7 @@ static int received_user_events;
 /*! \brief The number of user events we expect for this test */
 static int expected_user_events;
 
-/*! \brief Predicate for the \ref test_message_handler receiving a message */
+/*! \brief Predicate for the \ref test_msg_handler receiving a message */
 static int handler_received_message;
 
 /*! \brief Condition wait variable for all dialplan user events being received */

tests/test_voicemail_api.c

@@ -283,9 +283,9 @@
 	} } while (0)
 
 /*!
- * \internal                                                                                                              .
+ * \internal
- * \brief Playback a message on a channel or callback function                                                            .
+ * \brief Playback a message on a channel or callback function
- *                                                                                                                        .
+ *
  * \note The channel name must be test_channel.
  * \note Fail the test if the message could not be played.
  */
@@ -411,7 +411,7 @@ static void test_vm_api_destroy_mock_snapshot(struct ast_vm_msg_snapshot *snapsh
  * \internal
  * \brief Make a voicemail mailbox folder based on the values provided in a message snapshot
  *
- * \param snapshot The snapshot containing the information to create the folder from
+ * \param folder_path The snapshot containing the information to create the folder from
  *
  * \returns 0 on success
  * \returns 1 on failure
@@ -615,10 +615,10 @@ static void test_vm_api_remove_all_messages(void)
  * This creates 4 voicemails, stores them on the file system, and creates snapshot objects
  * representing them for expected/actual value comparisons in the array test_snapshots.
  *
- * test_snapshots[0] => in test_vm_1234@default, folder INBOX, message 0
+ * test_snapshots[0] => in test_vm_1234\@default, folder INBOX, message 0
- * test_snapshots[1] => in test_vm_1234@default, folder Old, message 0
+ * test_snapshots[1] => in test_vm_1234\@default, folder Old, message 0
- * test_snapshots[2] => in test_vm_2345@default, folder INBOX, message 0
+ * test_snapshots[2] => in test_vm_2345\@default, folder INBOX, message 0
- * test_snapshots[3] => in test_vm_2345@default, folder Old, message 1
+ * test_snapshots[3] => in test_vm_2345\@default, folder Old, message 1
  *
  * \returns 0 on success
  * \returns 1 on failure