SDL: test: don't use wiki urls for documentation comments

From 08bcee85703e69e7b079ac53c0078a9ac6eb1c96 Mon Sep 17 00:00:00 2001
From: Anonymous Maarten <[EMAIL REDACTED]>
Date: Thu, 2 Feb 2023 00:21:53 +0100
Subject: [PATCH] test: don't use wiki urls for documentation comments

Also make consistent use of \ as documentation escape character.
---
 src/render/software/SDL_rotate.c |  25 +++--
 src/test/SDL_test_fuzzer.c       |   4 +-
 src/test/SDL_test_log.c          |   2 +-
 test/testatomic.c                |   1 +
 test/testautomation_audio.c      |  50 ++++-----
 test/testautomation_clipboard.c  |  32 +++---
 test/testautomation_events.c     |  18 ++--
 test/testautomation_guid.c       |   8 +-
 test/testautomation_hints.c      |   4 +-
 test/testautomation_joystick.c   |   4 +-
 test/testautomation_keyboard.c   |  66 ++++++------
 test/testautomation_main.c       |   7 +-
 test/testautomation_mouse.c      |  52 ++++-----
 test/testautomation_pixels.c     |  16 +--
 test/testautomation_platform.c   |  71 ++++++-------
 test/testautomation_rect.c       | 174 +++++++++++++------------------
 test/testautomation_render.c     | 145 ++++++++++++--------------
 test/testautomation_rwops.c      |  61 +++++------
 test/testautomation_sdltest.c    |  46 ++++----
 test/testautomation_stdlib.c     |  10 +-
 test/testautomation_surface.c    |  24 ++---
 test/testautomation_syswm.c      |   2 +-
 test/testautomation_timer.c      |   8 +-
 test/testautomation_video.c      |  68 ++++++------
 test/testdrawchessboard.c        |   2 +-
 test/testgles2.c                 |   8 +-
 test/testgles2_sdf.c             |   2 +-
 test/testhaptic.c                |  17 ++-
 test/testlock.c                  |   2 +-
 test/testrumble.c                |   9 +-
 test/testutils.c                 |   6 +-
 31 files changed, 434 insertions(+), 510 deletions(-)

diff --git a/src/render/software/SDL_rotate.c b/src/render/software/SDL_rotate.c
index d2f381e8d7ff..f0908f687b7d 100644
--- a/src/render/software/SDL_rotate.c
+++ b/src/render/software/SDL_rotate.c
@@ -43,7 +43,7 @@ Andreas Schiffler -- aschiffler at ferzkopp dot net
 
 /* ---- Internally used structures */
 
-/* !
+/**
 \brief A 32 bit RGBA pixel.
 */
 typedef struct tColorRGBA
@@ -54,7 +54,7 @@ typedef struct tColorRGBA
     Uint8 a;
 } tColorRGBA;
 
-/* !
+/**
 \brief A 8bit Y/palette pixel.
 */
 typedef struct tColorY
@@ -62,7 +62,7 @@ typedef struct tColorY
     Uint8 y;
 } tColorY;
 
-/* !
+/**
 \brief Number of guard rows added to destination surfaces.
 
 This is a simple but effective workaround for observed issues.
@@ -74,7 +74,7 @@ to a situation where the program can segfault.
 */
 #define GUARD_ROWS (2)
 
-/* !
+/**
 \brief Returns colorkey info for a surface
 */
 static Uint32 get_colorkey(SDL_Surface *src)
@@ -99,14 +99,14 @@ static void rotate(double sx, double sy, double sinangle, double cosangle, const
     *dy += center->y;
 }
 
-/* !
+/**
 \brief Internal target surface sizing function for rotations with trig result return.
 
 \param width The source surface width.
 \param height The source surface height.
 \param angle The angle to rotate in degrees.
-\param dstwidth The calculated width of the destination surface.
-\param dstheight The calculated height of the destination surface.
+\param center The center of ratation
+\param rect_dest Bounding box of rotated rectangle
 \param cangle The sine of the angle
 \param sangle The cosine of the angle
 
@@ -248,7 +248,7 @@ static void transformSurfaceY90(SDL_Surface *src, SDL_Surface *dst, int angle, i
 
 #undef TRANSFORM_SURFACE_90
 
-/* !
+/**
 \brief Internal 32 bit rotozoomer with optional anti-aliasing.
 
 Rotates and zooms 32 bit RGBA/ABGR 'src' surface to 'dst' surface based on the control
@@ -264,7 +264,7 @@ Assumes dst surface was allocated with the correct dimensions.
 \param flipx Flag indicating horizontal mirroring should be applied.
 \param flipy Flag indicating vertical mirroring should be applied.
 \param smooth Flag indicating anti-aliasing should be used.
-\param dst_rect destination coordinates
+\param rect_dest destination coordinates
 \param center true center.
 */
 static void transformSurfaceRGBA(SDL_Surface *src, SDL_Surface *dst, int isin, int icos,
@@ -389,7 +389,7 @@ static void transformSurfaceRGBA(SDL_Surface *src, SDL_Surface *dst, int isin, i
     }
 }
 
-/* !
+/**
 
 \brief Rotates and zooms 8 bit palette/Y 'src' surface to 'dst' surface without smoothing.
 
@@ -404,7 +404,7 @@ Assumes dst surface was allocated with the correct dimensions.
 \param icos Integer version of cosine of angle.
 \param flipx Flag indicating horizontal mirroring should be applied.
 \param flipy Flag indicating vertical mirroring should be applied.
-\param dst_rect destination coordinates
+\param rect_dest destination coordinates
 \param center true center.
 */
 static void transformSurfaceY(SDL_Surface *src, SDL_Surface *dst, int isin, int icos, int flipx, int flipy,
@@ -461,7 +461,7 @@ static void transformSurfaceY(SDL_Surface *src, SDL_Surface *dst, int isin, int
     }
 }
 
-/* !
+/**
 \brief Rotates and zooms a surface with different horizontal and vertival scaling factors and optional anti-aliasing.
 
 Rotates a 32-bit or 8-bit 'src' surface to newly created 'dst' surface.
@@ -475,7 +475,6 @@ When using the NONE and MOD modes, color and alpha modulation must be applied be
 
 \param src The surface to rotozoom.
 \param angle The angle to rotate in degrees.
-\param zoomy The vertical coordinate of the center of rotation
 \param smooth Antialiasing flag; set to SMOOTHING_ON to enable.
 \param flipx Set to 1 to flip the image horizontally
 \param flipy Set to 1 to flip the image vertically
diff --git a/src/test/SDL_test_fuzzer.c b/src/test/SDL_test_fuzzer.c
index 4fc78c8dd684..e1c07dd8afc4 100644
--- a/src/test/SDL_test_fuzzer.c
+++ b/src/test/SDL_test_fuzzer.c
@@ -161,7 +161,7 @@ SDLTest_RandomIntegerInRange(Sint32 pMin, Sint32 pMax)
     return (Sint32)((number % ((max + 1) - min)) + min);
 }
 
-/* !
+/**
  * Generates a unsigned boundary value between the given boundaries.
  * Boundary values are inclusive. See the examples below.
  * If boundary2 < boundary1, the values are swapped.
@@ -288,7 +288,7 @@ SDLTest_RandomUint64BoundaryValue(Uint64 boundary1, Uint64 boundary2, SDL_bool v
                                                   validDomain);
 }
 
-/* !
+/**
  * Generates a signed boundary value between the given boundaries.
  * Boundary values are inclusive. See the examples below.
  * If boundary2 < boundary1, the values are swapped.
diff --git a/src/test/SDL_test_log.c b/src/test/SDL_test_log.c
index 3ad73199580d..fa5b72f17127 100644
--- a/src/test/SDL_test_log.c
+++ b/src/test/SDL_test_log.c
@@ -46,7 +46,7 @@ strftime_gcc2_workaround(char *s, size_t max, const char *fmt, const struct tm *
 #define strftime strftime_gcc2_workaround
 #endif
 
-/* !
+/**
  * Converts unix timestamp to its ascii representation in localtime
  *
  * Note: Uses a static buffer internally, so the return value
diff --git a/test/testatomic.c b/test/testatomic.c
index 95f25f7ac85e..aace3a06e9f0 100644
--- a/test/testatomic.c
+++ b/test/testatomic.c
@@ -9,6 +9,7 @@
   including commercial applications, and to alter it and redistribute it
   freely.
 */
+
 #include <SDL3/SDL.h>
 #include <SDL3/SDL_main.h>
 
diff --git a/test/testautomation_audio.c b/test/testautomation_audio.c
index 8a8dd102f3a3..130dc7f89ef5 100644
--- a/test/testautomation_audio.c
+++ b/test/testautomation_audio.c
@@ -57,8 +57,8 @@ static SDL_AudioDeviceID g_audio_id = -1;
 /**
  * \brief Stop and restart audio subsystem
  *
- * \sa https://wiki.libsdl.org/SDL_QuitSubSystem
- * \sa https://wiki.libsdl.org/SDL_InitSubSystem
+ * \sa SDL_QuitSubSystem
+ * \sa SDL_InitSubSystem
  */
 static int audio_quitInitAudioSubSystem(void *arg)
 {
@@ -75,8 +75,8 @@ static int audio_quitInitAudioSubSystem(void *arg)
 /**
  * \brief Start and stop audio directly
  *
- * \sa https://wiki.libsdl.org/SDL_InitAudio
- * \sa https://wiki.libsdl.org/SDL_QuitAudio
+ * \sa SDL_InitAudio
+ * \sa SDL_QuitAudio
  */
 static int audio_initQuitAudio(void *arg)
 {
@@ -131,10 +131,10 @@ static int audio_initQuitAudio(void *arg)
 /**
  * \brief Start, open, close and stop audio
  *
- * \sa https://wiki.libsdl.org/SDL_InitAudio
- * \sa https://wiki.libsdl.org/SDL_OpenAudioDevice
- * \sa https://wiki.libsdl.org/SDL_CloseAudioDevice
- * \sa https://wiki.libsdl.org/SDL_QuitAudio
+ * \sa SDL_InitAudio
+ * \sa SDL_OpenAudioDevice
+ * \sa SDL_CloseAudioDevice
+ * \sa SDL_QuitAudio
  */
 static int audio_initOpenCloseQuitAudio(void *arg)
 {
@@ -223,8 +223,8 @@ static int audio_initOpenCloseQuitAudio(void *arg)
 /**
  * \brief Pause and unpause audio
  *
- * \sa https://wiki.libsdl.org/SDL_PauseAudioDevice
- * \sa https://wiki.libsdl.org/SDL_PlayAudioDevice
+ * \sa SDL_PauseAudioDevice
+ * \sa SDL_PlayAudioDevice
  */
 static int audio_pauseUnpauseAudio(void *arg)
 {
@@ -350,8 +350,8 @@ static int audio_pauseUnpauseAudio(void *arg)
 /**
  * \brief Enumerate and name available audio devices (output and capture).
  *
- * \sa https://wiki.libsdl.org/SDL_GetNumAudioDevices
- * \sa https://wiki.libsdl.org/SDL_GetAudioDeviceName
+ * \sa SDL_GetNumAudioDevices
+ * \sa SDL_GetAudioDeviceName
  */
 static int audio_enumerateAndNameAudioDevices(void *arg)
 {
@@ -408,8 +408,8 @@ static int audio_enumerateAndNameAudioDevices(void *arg)
 /**
  * \brief Negative tests around enumeration and naming of audio devices.
  *
- * \sa https://wiki.libsdl.org/SDL_GetNumAudioDevices
- * \sa https://wiki.libsdl.org/SDL_GetAudioDeviceName
+ * \sa SDL_GetNumAudioDevices
+ * \sa SDL_GetAudioDeviceName
  */
 static int audio_enumerateAndNameAudioDevicesNegativeTests(void *arg)
 {
@@ -454,8 +454,8 @@ static int audio_enumerateAndNameAudioDevicesNegativeTests(void *arg)
 /**
  * \brief Checks available audio driver names.
  *
- * \sa https://wiki.libsdl.org/SDL_GetNumAudioDrivers
- * \sa https://wiki.libsdl.org/SDL_GetAudioDriver
+ * \sa SDL_GetNumAudioDrivers
+ * \sa SDL_GetAudioDriver
  */
 static int audio_printAudioDrivers(void *arg)
 {
@@ -485,7 +485,7 @@ static int audio_printAudioDrivers(void *arg)
 /**
  * \brief Checks current audio driver name with initialized audio.
  *
- * \sa https://wiki.libsdl.org/SDL_GetCurrentAudioDriver
+ * \sa SDL_GetCurrentAudioDriver
  */
 static int audio_printCurrentAudioDriver(void *arg)
 {
@@ -516,7 +516,7 @@ static int g_audioFrequencies[] = { 11025, 22050, 44100, 48000 };
 /**
  * \brief Builds various audio conversion structures
  *
- * \sa https://wiki.libsdl.org/SDL_CreateAudioStream
+ * \sa SDL_CreateAudioStream
  */
 static int audio_buildAudioStream(void *arg)
 {
@@ -581,7 +581,7 @@ static int audio_buildAudioStream(void *arg)
 /**
  * \brief Checks calls with invalid input to SDL_CreateAudioStream
  *
- * \sa https://wiki.libsdl.org/SDL_CreateAudioStream
+ * \sa SDL_CreateAudioStream
  */
 static int audio_buildAudioStreamNegative(void *arg)
 {
@@ -662,7 +662,7 @@ static int audio_buildAudioStreamNegative(void *arg)
 /**
  * \brief Checks current audio status.
  *
- * \sa https://wiki.libsdl.org/SDL_GetAudioDeviceStatus
+ * \sa SDL_GetAudioDeviceStatus
  */
 static int audio_getAudioStatus(void *arg)
 {
@@ -681,7 +681,7 @@ static int audio_getAudioStatus(void *arg)
 /**
  * \brief Opens, checks current audio status, and closes a device.
  *
- * \sa https://wiki.libsdl.org/SDL_GetAudioStatus
+ * \sa SDL_GetAudioStatus
  */
 static int audio_openCloseAndGetAudioStatus(void *arg)
 {
@@ -741,8 +741,8 @@ static int audio_openCloseAndGetAudioStatus(void *arg)
 /**
  * \brief Locks and unlocks open audio device.
  *
- * \sa https://wiki.libsdl.org/SDL_LockAudioDevice
- * \sa https://wiki.libsdl.org/SDL_UnlockAudioDevice
+ * \sa SDL_LockAudioDevice
+ * \sa SDL_UnlockAudioDevice
  */
 static int audio_lockUnlockOpenAudioDevice(void *arg)
 {
@@ -805,7 +805,7 @@ static int audio_lockUnlockOpenAudioDevice(void *arg)
 /**
  * \brief Convert audio using various conversion structures
  *
- * \sa https://wiki.libsdl.org/SDL_CreateAudioStream
+ * \sa SDL_CreateAudioStream
  */
 static int audio_convertAudio(void *arg)
 {
@@ -929,7 +929,7 @@ static int audio_convertAudio(void *arg)
 /**
  * \brief Opens, checks current connected status, and closes a device.
  *
- * \sa https://wiki.libsdl.org/SDL_AudioDeviceConnected
+ * \sa SDL_AudioDeviceConnected
  */
 static int audio_openCloseAudioDeviceConnected(void *arg)
 {
diff --git a/test/testautomation_clipboard.c b/test/testautomation_clipboard.c
index f02148f28137..d94cad922861 100644
--- a/test/testautomation_clipboard.c
+++ b/test/testautomation_clipboard.c
@@ -11,8 +11,7 @@
 /**
  * \brief Check call to SDL_HasClipboardText
  *
- * \sa
- * http://wiki.libsdl.org/SDL_HasClipboardText
+ * \sa SDL_HasClipboardText
  */
 int clipboard_testHasClipboardText(void *arg)
 {
@@ -25,8 +24,7 @@ int clipboard_testHasClipboardText(void *arg)
 /**
  * \brief Check call to SDL_HasPrimarySelectionText
  *
- * \sa
- * http://wiki.libsdl.org/SDL_HasPrimarySelectionText
+ * \sa SDL_HasPrimarySelectionText
  */
 int clipboard_testHasPrimarySelectionText(void *arg)
 {
@@ -39,8 +37,7 @@ int clipboard_testHasPrimarySelectionText(void *arg)
 /**
  * \brief Check call to SDL_GetClipboardText
  *
- * \sa
- * http://wiki.libsdl.org/SDL_GetClipboardText
+ * \sa SDL_GetClipboardText
  */
 int clipboard_testGetClipboardText(void *arg)
 {
@@ -56,8 +53,7 @@ int clipboard_testGetClipboardText(void *arg)
 /**
  * \brief Check call to SDL_GetPrimarySelectionText
  *
- * \sa
- * http://wiki.libsdl.org/SDL_GetPrimarySelectionText
+ * \sa SDL_GetPrimarySelectionText
  */
 int clipboard_testGetPrimarySelectionText(void *arg)
 {
@@ -72,8 +68,7 @@ int clipboard_testGetPrimarySelectionText(void *arg)
 
 /**
  * \brief Check call to SDL_SetClipboardText
- * \sa
- * http://wiki.libsdl.org/SDL_SetClipboardText
+ * \sa SDL_SetClipboardText
  */
 int clipboard_testSetClipboardText(void *arg)
 {
@@ -100,8 +95,7 @@ int clipboard_testSetClipboardText(void *arg)
 
 /**
  * \brief Check call to SDL_SetPrimarySelectionText
- * \sa
- * http://wiki.libsdl.org/SDL_SetPrimarySelectionText
+ * \sa SDL_SetPrimarySelectionText
  */
 int clipboard_testSetPrimarySelectionText(void *arg)
 {
@@ -128,10 +122,9 @@ int clipboard_testSetPrimarySelectionText(void *arg)
 
 /**
  * \brief End-to-end test of SDL_xyzClipboardText functions
- * \sa
- * http://wiki.libsdl.org/SDL_HasClipboardText
- * http://wiki.libsdl.org/SDL_GetClipboardText
- * http://wiki.libsdl.org/SDL_SetClipboardText
+ * \sa SDL_HasClipboardText
+ * \sa SDL_GetClipboardText
+ * \sa SDL_SetClipboardText
  */
 int clipboard_testClipboardTextFunctions(void *arg)
 {
@@ -206,10 +199,9 @@ int clipboard_testClipboardTextFunctions(void *arg)
 
 /**
  * \brief End-to-end test of SDL_xyzPrimarySelectionText functions
- * \sa
- * http://wiki.libsdl.org/SDL_HasPrimarySelectionText
- * http://wiki.libsdl.org/SDL_GetPrimarySelectionText
- * http://wiki.libsdl.org/SDL_SetPrimarySelectionText
+ * \sa SDL_HasPrimarySelectionText
+ * \sa SDL_GetPrimarySelectionText
+ * \sa SDL_SetPrimarySelectionText
  */
 int clipboard_testPrimarySelectionTextFunctions(void *arg)
 {
diff --git a/test/testautomation_events.c b/test/testautomation_events.c
index adf7be560e7b..e246f35de537 100644
--- a/test/testautomation_events.c
+++ b/test/testautomation_events.c
@@ -37,10 +37,10 @@ static int SDLCALL events_sampleNullEventFilter(void *userdata, SDL_Event *event
 }
 
 /**
- * @brief Test pumping and peeking events.
+ * \brief Test pumping and peeking events.
  *
- * @sa http://wiki.libsdl.org/SDL_PumpEvents
- * @sa http://wiki.libsdl.org/SDL_PollEvent
+ * \sa SDL_PumpEvents
+ * \sa SDL_PollEvent
  */
 int events_pushPumpAndPollUserevent(void *arg)
 {
@@ -69,10 +69,10 @@ int events_pushPumpAndPollUserevent(void *arg)
 }
 
 /**
- * @brief Adds and deletes an event watch function with NULL userdata
+ * \brief Adds and deletes an event watch function with NULL userdata
  *
- * @sa http://wiki.libsdl.org/SDL_AddEventWatch
- * @sa http://wiki.libsdl.org/SDL_DelEventWatch
+ * \sa SDL_AddEventWatch
+ * \sa SDL_DelEventWatch
  *
  */
 int events_addDelEventWatch(void *arg)
@@ -118,10 +118,10 @@ int events_addDelEventWatch(void *arg)
 }
 
 /**
- * @brief Adds and deletes an event watch function with userdata
+ * \brief Adds and deletes an event watch function with userdata
  *
- * @sa http://wiki.libsdl.org/SDL_AddEventWatch
- * @sa http://wiki.libsdl.org/SDL_DelEventWatch
+ * \sa SDL_AddEventWatch
+ * \sa SDL_DelEventWatch
  *
  */
 int events_addDelEventWatchWithUserdata(void *arg)
diff --git a/test/testautomation_guid.c b/test/testautomation_guid.c
index 912def97ca28..960dabfbb283 100644
--- a/test/testautomation_guid.c
+++ b/test/testautomation_guid.c
@@ -55,9 +55,9 @@ upper_lower_to_bytestring(Uint8 *out, Uint64 upper, Uint64 lower)
 /* Test case functions */
 
 /**
- * @brief Check String-to-GUID conversion
+ * \brief Check String-to-GUID conversion
  *
- * @sa SDL_GUIDFromString
+ * \sa SDL_GUIDFromString
  */
 static int
 TestGuidFromString(void *arg)
@@ -80,9 +80,9 @@ TestGuidFromString(void *arg)
 }
 
 /**
- * @brief Check GUID-to-String conversion
+ * \brief Check GUID-to-String conversion
  *
- * @sa SDL_GUIDToString
+ * \sa SDL_GUIDToString
  */
 static int
 TestGuidToString(void *arg)
diff --git a/test/testautomation_hints.c b/test/testautomation_hints.c
index e07342052454..b7919f336480 100644
--- a/test/testautomation_hints.c
+++ b/test/testautomation_hints.c
@@ -59,7 +59,7 @@ const int numHintsEnum = SDL_arraysize(HintsEnum);
 /* Test case functions */
 
 /**
- * @brief Call to SDL_GetHint
+ * \brief Call to SDL_GetHint
  */
 int hints_getHint(void *arg)
 {
@@ -88,7 +88,7 @@ static void SDLCALL hints_testHintChanged(void *userdata, const char *name, cons
 }
 
 /**
- * @brief Call to SDL_SetHint
+ * \brief Call to SDL_SetHint
  */
 int hints_setHint(void *arg)
 {
diff --git a/test/testautomation_joystick.c b/test/testautomation_joystick.c
index 37f21f79bdcd..d3420f338158 100644
--- a/test/testautomation_joystick.c
+++ b/test/testautomation_joystick.c
@@ -11,9 +11,9 @@
 /* Test case functions */
 
 /**
- * @brief Check virtual joystick creation
+ * \brief Check virtual joystick creation
  *
- * @sa SDL_AttachVirtualJoystickEx
+ * \sa SDL_AttachVirtualJoystickEx
  */
 static int
 TestVirtualJoystick(void *arg)
diff --git a/test/testautomation_keyboard.c b/test/testautomation_keyboard.c
index 6e03cc6546a9..d542deeda333 100644
--- a/test/testautomation_keyboard.c
+++ b/test/testautomation_keyboard.c
@@ -10,9 +10,9 @@
 /* Test case functions */
 
 /**
- * @brief Check call to SDL_GetKeyboardState with and without numkeys reference.
+ * \brief Check call to SDL_GetKeyboardState with and without numkeys reference.
  *
- * @sa http://wiki.libsdl.org/SDL_GetKeyboardState
+ * \sa SDL_GetKeyboardState
  */
 int keyboard_getKeyboardState(void *arg)
 {
@@ -35,9 +35,9 @@ int keyboard_getKeyboardState(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetKeyboardFocus
+ * \brief Check call to SDL_GetKeyboardFocus
  *
- * @sa http://wiki.libsdl.org/SDL_GetKeyboardFocus
+ * \sa SDL_GetKeyboardFocus
  */
 int keyboard_getKeyboardFocus(void *arg)
 {
@@ -49,9 +49,9 @@ int keyboard_getKeyboardFocus(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetKeyFromName for known, unknown and invalid name.
+ * \brief Check call to SDL_GetKeyFromName for known, unknown and invalid name.
  *
- * @sa http://wiki.libsdl.org/SDL_GetKeyFromName
+ * \sa SDL_GetKeyFromName
  */
 int keyboard_getKeyFromName(void *arg)
 {
@@ -114,9 +114,9 @@ static void checkInvalidScancodeError()
 }
 
 /**
- * @brief Check call to SDL_GetKeyFromScancode
+ * \brief Check call to SDL_GetKeyFromScancode
  *
- * @sa http://wiki.libsdl.org/SDL_GetKeyFromScancode
+ * \sa SDL_GetKeyFromScancode
  */
 int keyboard_getKeyFromScancode(void *arg)
 {
@@ -152,9 +152,9 @@ int keyboard_getKeyFromScancode(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetKeyName
+ * \brief Check call to SDL_GetKeyName
  *
- * @sa http://wiki.libsdl.org/SDL_GetKeyName
+ * \sa SDL_GetKeyName
  */
 int keyboard_getKeyName(void *arg)
 {
@@ -207,9 +207,9 @@ int keyboard_getKeyName(void *arg)
 }
 
 /**
- * @brief SDL_GetScancodeName negative cases
+ * \brief SDL_GetScancodeName negative cases
  *
- * @sa http://wiki.libsdl.org/SDL_GetScancodeName
+ * \sa SDL_GetScancodeName
  */
 int keyboard_getScancodeNameNegative(void *arg)
 {
@@ -233,9 +233,9 @@ int keyboard_getScancodeNameNegative(void *arg)
 }
 
 /**
- * @brief SDL_GetKeyName negative cases
+ * \brief SDL_GetKeyName negative cases
  *
- * @sa http://wiki.libsdl.org/SDL_GetKeyName
+ * \sa SDL_GetKeyName
  */
 int keyboard_getKeyNameNegative(void *arg)
 {
@@ -269,10 +269,10 @@ int keyboard_getKeyNameNegative(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetModState and SDL_SetModState
+ * \brief Check call to SDL_GetModState and SDL_SetModState
  *
- * @sa http://wiki.libsdl.org/SDL_GetModState
- * @sa http://wiki.libsdl.org/SDL_SetModState
+ * \sa SDL_GetModState
+ * \sa SDL_SetModState
  */
 int keyboard_getSetModState(void *arg)
 {
@@ -328,10 +328,10 @@ int keyboard_getSetModState(void *arg)
 }
 
 /**
- * @brief Check call to SDL_StartTextInput and SDL_StopTextInput
+ * \brief Check call to SDL_StartTextInput and SDL_StopTextInput
  *
- * @sa http://wiki.libsdl.org/SDL_StartTextInput
- * @sa http://wiki.libsdl.org/SDL_StopTextInput
+ * \sa SDL_StartTextInput
+ * \sa SDL_StopTextInput
  */
 int keyboard_startStopTextInput(void *arg)
 {
@@ -374,9 +374,9 @@ static void testSetTextInputRect(SDL_Rect refRect)
 }
 
 /**
- * @brief Check call to SDL_SetTextInputRect
+ * \brief Check call to SDL_SetTextInputRect
  *
- * @sa http://wiki.libsdl.org/SDL_SetTextInputRect
+ * \sa SDL_SetTextInputRect
  */
 int keyboard_setTextInputRect(void *arg)
 {
@@ -453,9 +453,9 @@ int keyboard_setTextInputRect(void *arg)
 }
 
 /**
- * @brief Check call to SDL_SetTextInputRect with invalid data
+ * \brief Check call to SDL_SetTextInputRect with invalid data
  *
- * @sa http://wiki.libsdl.org/SDL_SetTextInputRect
+ * \sa SDL_SetTextInputRect
  */
 int keyboard_setTextInputRectNegative(void *arg)
 {
@@ -490,10 +490,10 @@ int keyboard_setTextInputRectNegative(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetScancodeFromKey
+ * \brief Check call to SDL_GetScancodeFromKey
  *
- * @sa http://wiki.libsdl.org/SDL_GetScancodeFromKey
- * @sa http://wiki.libsdl.org/SDL_Keycode
+ * \sa SDL_GetScancodeFromKey
+ * \sa SDL_Keycode
  */
 int keyboard_getScancodeFromKey(void *arg)
 {
@@ -513,10 +513,10 @@ int keyboard_getScancodeFromKey(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetScancodeFromName
+ * \brief Check call to SDL_GetScancodeFromName
  *
- * @sa http://wiki.libsdl.org/SDL_GetScancodeFromName
- * @sa http://wiki.libsdl.org/SDL_Keycode
+ * \sa SDL_GetScancodeFromName
+ * \sa SDL_Keycode
  */
 int keyboard_getScancodeFromName(void *arg)
 {
@@ -584,10 +584,10 @@ static void checkInvalidNameError()
 }
 
 /**
- * @brief Check call to SDL_GetScancodeFromName with invalid data
+ * \brief Check call to SDL_GetScancodeFromName with invalid data
  *
- * @sa http://wiki.libsdl.org/SDL_GetScancodeFromName
- * @sa http://wiki.libsdl.org/SDL_Keycode
+ * \sa SDL_GetScancodeFromName
+ * \sa SDL_Keycode
  */
 int keyboard_getScancodeFromNameNegative(void *arg)
 {
diff --git a/test/testautomation_main.c b/test/testautomation_main.c
index a7b5cc4976cd..acdd5ee7c273 100644
--- a/test/testautomation_main.c
+++ b/test/testautomation_main.c
@@ -9,11 +9,10 @@
 #include <SDL3/SDL.h>
 #include <SDL3/SDL_test.h>
 
-/* !
+/**
  * \brief Tests SDL_InitSubSystem() and SDL_QuitSubSystem()
- * \sa
- * http://wiki.libsdl.org/SDL_Init
- * http://wiki.libsdl.org/SDL_Quit
+ * \sa SDL_Init
+ * \sa SDL_Quit
  */
 static int main_testInitQuitSubSystem(void *arg)
 {
diff --git a/test/testautomation_mouse.c b/test/testautomation_mouse.c
index e451ecdef8df..e25bf40d4d4f 100644
--- a/test/testautomation_mouse.c
+++ b/test/testautomation_mouse.c
@@ -24,7 +24,7 @@ static int mouseStateCheck(Uint32 state)
 }
 
 /**
- * @brief Check call to SDL_GetMouseState
+ * \brief Check call to SDL_GetMouseState
  *
  */
 int mouse_getMouseState(void *arg)
@@ -69,7 +69,7 @@ int mouse_getMouseState(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetRelativeMouseState
+ * \brief Check call to SDL_GetRelativeMouseState
  *
  */
 int mouse_getRelativeMouseState(void *arg)
@@ -187,10 +187,10 @@ static SDL_Cursor *initArrowCursor(const char *image[])
 }
 
 /**
- * @brief Check call to SDL_CreateCursor and SDL_DestroyCursor
+ * \brief Check call to SDL_CreateCursor and SDL_DestroyCursor
  *
- * @sa http://wiki.libsdl.org/SDL_CreateCursor
- * @sa http://wiki.libsdl.org/SDL_DestroyCursor
+ * \sa SDL_CreateCursor
+ * \sa SDL_DestroyCursor
  */
 int mouse_createFreeCursor(void *arg)
 {
@@ -212,10 +212,10 @@ int mouse_createFreeCursor(void *arg)
 }
 
 /**
- * @brief Check call to SDL_CreateColorCursor and SDL_DestroyCursor
+ * \brief Check call to SDL_CreateColorCursor and SDL_DestroyCursor
  *
- * @sa http://wiki.libsdl.org/SDL_CreateColorCursor
- * @sa http://wiki.libsdl.org/SDL_DestroyCursor
+ * \sa SDL_CreateColorCursor
+ * \sa SDL_DestroyCursor
  */
 int mouse_createFreeColorCursor(void *arg)
 {
@@ -268,9 +268,9 @@ static void changeCursorVisibility(SDL_bool state)
 }
 
 /**
- * @brief Check call to SDL_ShowCursor
+ * \brief Check call to SDL_ShowCursor
  *
- * @sa http://wiki.libsdl.org/SDL_ShowCursor
+ * \sa SDL_ShowCursor
  */
 int mouse_showCursor(void *arg)
 {
@@ -293,9 +293,9 @@ int mouse_showCursor(void *arg)
 }
 
 /**
- * @brief Check call to SDL_SetCursor
+ * \brief Check call to SDL_SetCursor
  *
- * @sa http://wiki.libsdl.org/SDL_SetCursor
+ * \sa SDL_SetCursor
  */
 int mouse_setCursor(void *arg)
 {
@@ -325,9 +325,9 @@ int mouse_setCursor(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetCursor
+ * \brief Check call to SDL_GetCursor
  *
- * @sa http://wiki.libsdl.org/SDL_GetCursor
+ * \sa SDL_GetCursor
  */
 int mouse_getCursor(void *arg)
 {
@@ -342,10 +342,10 @@ int mouse_getCursor(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetRelativeMouseMode and SDL_SetRelativeMouseMode
+ * \brief Check call to SDL_GetRelativeMouseMode and SDL_SetRelativeMouseMode
  *
- * @sa http://wiki.libsdl.org/SDL_GetRelativeMouseMode
- * @sa http://wiki.libsdl.org/SDL_SetRelativeMouseMode
+ * \sa SDL_GetRelativeMouseMode
+ * \sa SDL_SetRelativeMouseMode
  */
 int mouse_getSetRelativeMouseMode(void *arg)
 {
@@ -412,7 +412,7 @@ static SDL_Window *createMouseSuiteTestWindow()
     return window;
 }
 
-/*
+/**
  * Destroy test window
  */
 static void destroyMouseSuiteTestWindow(SDL_Window *window)
@@ -425,9 +425,9 @@ static void destroyMouseSuiteTestWindow(SDL_Window *window)
 }
 
 /**
- * @brief Check call to SDL_WarpMouseInWindow
+ * \brief Check call to SDL_WarpMouseInWindow
  *
- * @sa http://wiki.libsdl.org/SDL_WarpMouseInWindow
+ * \sa SDL_WarpMouseInWindow
  */
 int mouse_warpMouseInWindow(void *arg)
 {
@@ -488,9 +488,9 @@ int mouse_warpMouseInWindow(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetMouseFocus
+ * \brief Check call to SDL_GetMouseFocus
  *
- * @sa http://wiki.libsdl.org/SDL_GetMouseFocus
+ * \sa SDL_GetMouseFocus
  */
 int mouse_getMouseFocus(void *arg)
 {
@@ -548,9 +548,9 @@ int mouse_getMouseFocus(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetDefaultCursor
+ * \brief Check call to SDL_GetDefaultCursor
  *
- * @sa http://wiki.libsdl.org/SDL_GetDefaultCursor
+ * \sa SDL_GetDefaultCursor
  */
 int mouse_getDefaultCursor(void *arg)
 {
@@ -565,9 +565,9 @@ int mouse_getDefaultCursor(void *arg)
 }
 
 /**
- * @brief Check call to SDL_GetGlobalMouseState
+ * \brief Check call to SDL_GetGlobalMouseState
  *
- * @sa http://wiki.libsdl.org/SDL_GetGlobalMouseState
+ * \sa SDL_GetGlobalMouseState
  */
 int mouse_getGlobalMouseState(void *arg)
 {
diff --git a/test/testautomation_pixels.c b/test/testautomation_pixels.c
index 4ba4474caebe..6faaf7211eb5 100644
--- a/test/testautomation_pixels.c
+++ b/test/testautomation_pixels.c
@@ -104,10 +104,10 @@ const char *g_invalidPixelFormatsVerbose[] = {
 /* Test case functions */
 
 /**
- * @brief Call to SDL_CreatePixelFormat and SDL_DestroyPixelFormat
+ * \brief Call to SDL_CreatePixelFormat and SDL_DestroyPixelFormat
  *
- * @sa http://wiki.libsdl.org/SDL_CreatePixelFormat
- * @sa http://wiki.libsdl.org/SDL_DestroyPixelFormat
+ * \sa SDL_CreatePixelFormat
+ * \sa SDL_DestroyPixelFormat
  */
 int pixels_allocFreeFormat(void *arg)
 {
@@ -200,9 +200,9 @@ int pixels_allocFreeFormat(void *arg)
 }
 
 /**
- * @brief Call to SDL_GetPixelFormatName
+ * \brief Call to SDL_GetPixelFormatName
  *
- * @sa http://wiki.libsdl.org/SDL_GetPixelFormatName
+ * \sa SDL_GetPixelFormatName
  */
 int pixels_getPixelFormatName(void *arg)
 {
@@ -267,10 +267,10 @@ int pixels_getPixelFormatName(void *arg)
 }
 
 /**
- * @brief Call to SDL_CreatePalette and SDL_DestroyPalette
+ * \brief Call to SDL_CreatePalette and SDL_DestroyPalette
  *
- * @sa http://wiki.libsdl.org/SDL_CreatePalette
- * @sa http://wiki.libsdl.org/SDL_DestroyPalette
+ * \sa SDL_CreatePalette
+ * \sa SDL_DestroyPalette
  */
 int pixels_allocFreePalette(void *arg)
 {
diff --git a/test/testautomation_platform.c b/test/testautomation_platform.c
index 5e67fb8c2bbb..f1fdb16f99e8 100644
--- a/test/testautomation_platform.c
+++ b/test/testautomation_platform.c
@@ -10,7 +10,7 @@
 /* Helper functions */
 
 /**
- * @brief Compare sizes of types.
+ * \brief Compare sizes of types.
  *
  * @note Watcom C flags these as Warning 201: "Unreachable code" if you just
  *  compare them directly, so we push it through a function to keep the
@@ -24,7 +24,7 @@ static int compareSizeOfType(size_t sizeoftype, size_t hardcodetype)
 /* Test case functions */
 
 /**
- * @brief Tests type sizes.
+ * \brief Tests type sizes.
  */
 int platform_testTypes(void *arg)
 {
@@ -46,7 +46,7 @@ int platform_testTypes(void *arg)
 }
 
 /**
- * @brief Tests platform endianness and SDL_SwapXY functions.
+ * \brief Tests platform endianness and SDL_SwapXY functions.
  */
 int platform_testEndianessAndSwap(void *arg)
 {
@@ -116,13 +116,12 @@ int platform_testEndianessAndSwap(void *arg)
     return TEST_COMPLETED;
 }
 
-/* !
+/**
  * \brief Tests SDL_GetXYZ() functions
- * \sa
- * http://wiki.libsdl.org/SDL_GetPlatform
- * http://wiki.libsdl.org/SDL_GetCPUCount
- * http://wiki.libsdl.org/SDL_GetCPUCacheLineSize
- * http://wiki.libsdl.org/SDL_GetRevision
+ * \sa SDL_GetPlatform
+ * \sa SDL_GetCPUCount
+ * \sa SDL_GetRevision
+ * \sa SDL_GetCPUCacheLineSize
  */
 int platform_testGetFunctions(void *arg)
 {
@@ -161,18 +160,17 @@ int platform_testGetFunctions(void *arg)
     return TEST_COMPLETED;
 }
 
-/* !
+/**
  * \brief Tests SDL_HasXYZ() functions
- * \sa
- * http://wiki.libsdl.org/SDL_HasAltiVec
- * http://wiki.libsdl.org/SDL_HasMMX
- * http://wiki.libsdl.org/SDL_HasRDTSC
- * http://wiki.libsdl.org/SDL_HasSSE
- * http://wiki.libsdl.org/SDL_HasSSE2
- * http://wiki.libsdl.org/SDL_HasSSE3
- * http://wiki.libsdl.org/SDL_HasSSE41
- * http://wiki.libsdl.org/SDL_HasSSE42
- * http://wiki.libsdl.org/SDL_HasAVX
+ * \sa SDL_HasAltiVec
+ * \sa SDL_HasMMX
+ * \sa SDL_HasRDTSC
+ * \sa SDL_HasSSE
+ * \sa SDL_HasSSE2
+ * \sa SDL_HasSSE3
+ * \sa SDL_HasSSE41
+ * \sa SDL_HasSSE42
+ * \sa SDL_HasAVX
  */
 int platform_testHasFunctions(void *arg)
 {
@@ -208,10 +206,9 @@ int platform_testHasFunctions(void *arg)
     return TEST_COMPLETED;
 }
 
-/* !
+/**
  * \brief Tests SDL_GetVersion
- * \sa
- * http://wiki.libsdl.org/SDL_GetVersion
+ * \sa SDL_GetVersion
  */
 int platform_testGetVersion(void *arg)
 {
@@ -232,7 +229,7 @@ int platform_testGetVersion(void *arg)
     return TEST_COMPLETED;
 }
 
-/* !
+/**
  * \brief Tes

(Patch may be truncated, please check the link at the top of this post.)