docs: Remove Doxygen `\brief` tags.

Doxygen and the wiki bridge don't need them; they'll both just use the first
line/sentence instead.

Fixes #8446.

include/SDL3/SDL_assert.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_assert.h
  *
- *  \brief Header file for assertion SDL API functions
+ *  Header file for assertion SDL API functions
  */
 
 #ifndef SDL_assert_h_

include/SDL3/SDL_atomic.h

@@ -22,7 +22,7 @@
 /**
  * \file SDL_atomic.h
  *
- * \brief Atomic operations.
+ * Atomic operations.
  *
  * IMPORTANT:
  * If you are not an expert in concurrent lockless programming, you should
@@ -263,8 +263,9 @@ typedef void (*SDL_KernelMemoryBarrierFunc)();
 
 
 /**
- * \brief A type representing an atomic integer value.  It is a struct
+ * A type representing an atomic integer value.
- *        so people don't accidentally use numeric operations on it.
+ *
+ * It is a struct so people don't accidentally use numeric operations on it.
  */
 typedef struct { int value; } SDL_AtomicInt;
 
@@ -340,14 +341,14 @@ extern DECLSPEC int SDLCALL SDL_AtomicGet(SDL_AtomicInt *a);
 extern DECLSPEC int SDLCALL SDL_AtomicAdd(SDL_AtomicInt *a, int v);
 
 /**
- * \brief Increment an atomic variable used as a reference count.
+ * Increment an atomic variable used as a reference count.
  */
 #ifndef SDL_AtomicIncRef
 #define SDL_AtomicIncRef(a)    SDL_AtomicAdd(a, 1)
 #endif
 
 /**
- * \brief Decrement an atomic variable used as a reference count.
+ * Decrement an atomic variable used as a reference count.
  *
  * \return SDL_TRUE if the variable reached zero after decrementing,
  *         SDL_FALSE otherwise

include/SDL3/SDL_audio.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_audio.h
  *
- *  \brief Audio functionality for the SDL library.
+ *  Audio functionality for the SDL library.
  */
 
 #ifndef SDL_audio_h_
@@ -54,7 +54,7 @@ extern "C" {
  */
 
 /**
- *  \brief Audio format flags.
+ *  Audio format flags.
  *
  *  These are what the 16 bits in SDL_AudioFormat currently mean...
  *  (Unspecified bits are always zero).

include/SDL3/SDL_bits.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_bits.h
  *
- *  \brief Functions for fiddling with bits and bitmasks.
+ *  Functions for fiddling with bits and bitmasks.
  */
 
 #ifndef SDL_bits_h_

include/SDL3/SDL_blendmode.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_blendmode.h
  *
- *  \brief Header file declaring the SDL_BlendMode enumeration
+ *  Header file declaring the SDL_BlendMode enumeration
  */
 
 #ifndef SDL_blendmode_h_
@@ -35,7 +35,7 @@ extern "C" {
 #endif
 
 /**
- *  \brief The blend mode used in SDL_RenderTexture() and drawing operations.
+ *  The blend mode used in SDL_RenderTexture() and drawing operations.
  */
 typedef enum
 {
@@ -60,7 +60,7 @@ typedef enum
 } SDL_BlendMode;
 
 /**
- *  \brief The blend operation used when combining source and destination pixel components
+ *  The blend operation used when combining source and destination pixel components
  */
 typedef enum
 {
@@ -72,7 +72,7 @@ typedef enum
 } SDL_BlendOperation;
 
 /**
- *  \brief The normalized factor used to multiply pixel components
+ *  The normalized factor used to multiply pixel components
  */
 typedef enum
 {

include/SDL3/SDL_clipboard.h

@@ -22,7 +22,7 @@
 /**
  * \file SDL_clipboard.h
  *
- * \brief Include file for SDL clipboard handling
+ * Include file for SDL clipboard handling
  */
 
 #ifndef SDL_clipboard_h_

include/SDL3/SDL_copying.h

@@ -22,5 +22,5 @@
 /**
  *  \file SDL_copying.h
  *
- *  \brief Header file containing SDL's license.
+ *  Header file containing SDL's license.
  */

include/SDL3/SDL_cpuinfo.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_cpuinfo.h
  *
- *  \brief CPU feature detection for SDL.
+ *  CPU feature detection for SDL.
  */
 
 #ifndef SDL_cpuinfo_h_

include/SDL3/SDL_egl.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_egl.h
  *
- *  \brief This is a simple file to encapsulate the EGL API headers.
+ *  This is a simple file to encapsulate the EGL API headers.
  */
 
 #if !defined(_MSC_VER) && !defined(__ANDROID__) && !defined(SDL_USE_BUILTIN_OPENGL_DEFINITIONS)

include/SDL3/SDL_endian.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_endian.h
  *
- *  \brief Functions for reading and writing endian-specific values
+ *  Functions for reading and writing endian-specific values
  */
 
 #ifndef SDL_endian_h_

include/SDL3/SDL_events.h

@@ -210,7 +210,7 @@ typedef enum
 } SDL_EventType;
 
 /**
- *  \brief Fields shared by every event
+ *  Fields shared by every event
  */
 typedef struct SDL_CommonEvent
 {
@@ -219,7 +219,7 @@ typedef struct SDL_CommonEvent
 } SDL_CommonEvent;
 
 /**
- *  \brief Display state change event data (event.display.*)
+ *  Display state change event data (event.display.*)
  */
 typedef struct SDL_DisplayEvent
 {
@@ -230,7 +230,7 @@ typedef struct SDL_DisplayEvent
 } SDL_DisplayEvent;
 
 /**
- *  \brief Window state change event data (event.window.*)
+ *  Window state change event data (event.window.*)
  */
 typedef struct SDL_WindowEvent
 {
@@ -242,7 +242,7 @@ typedef struct SDL_WindowEvent
 } SDL_WindowEvent;
 
 /**
- *  \brief Keyboard button event structure (event.key.*)
+ *  Keyboard button event structure (event.key.*)
  */
 typedef struct SDL_KeyboardEvent
 {
@@ -258,7 +258,7 @@ typedef struct SDL_KeyboardEvent
 
 #define SDL_TEXTEDITINGEVENT_TEXT_SIZE 64
 /**
- *  \brief Keyboard text editing event structure (event.edit.*)
+ *  Keyboard text editing event structure (event.edit.*)
  *
  *  The `text` is owned by SDL and should be copied if the application
  *  wants to hold onto it beyond the scope of handling this event.
@@ -275,7 +275,7 @@ typedef struct SDL_TextEditingEvent
 
 #define SDL_TEXTINPUTEVENT_TEXT_SIZE 64
 /**
- *  \brief Keyboard text input event structure (event.text.*)
+ *  Keyboard text input event structure (event.text.*)
  *
  *  The `text` is owned by SDL and should be copied if the application
  *  wants to hold onto it beyond the scope of handling this event.
@@ -289,7 +289,7 @@ typedef struct SDL_TextInputEvent
 } SDL_TextInputEvent;
 
 /**
- *  \brief Mouse motion event structure (event.motion.*)
+ *  Mouse motion event structure (event.motion.*)
  */
 typedef struct SDL_MouseMotionEvent
 {
@@ -305,7 +305,7 @@ typedef struct SDL_MouseMotionEvent
 } SDL_MouseMotionEvent;
 
 /**
- *  \brief Mouse button event structure (event.button.*)
+ *  Mouse button event structure (event.button.*)
  */
 typedef struct SDL_MouseButtonEvent
 {
@@ -322,7 +322,7 @@ typedef struct SDL_MouseButtonEvent
 } SDL_MouseButtonEvent;
 
 /**
- *  \brief Mouse wheel event structure (event.wheel.*)
+ *  Mouse wheel event structure (event.wheel.*)
  */
 typedef struct SDL_MouseWheelEvent
 {
@@ -338,7 +338,7 @@ typedef struct SDL_MouseWheelEvent
 } SDL_MouseWheelEvent;
 
 /**
- *  \brief Joystick axis motion event structure (event.jaxis.*)
+ *  Joystick axis motion event structure (event.jaxis.*)
  */
 typedef struct SDL_JoyAxisEvent
 {
@@ -354,7 +354,7 @@ typedef struct SDL_JoyAxisEvent
 } SDL_JoyAxisEvent;
 
 /**
- *  \brief Joystick hat position change event structure (event.jhat.*)
+ *  Joystick hat position change event structure (event.jhat.*)
  */
 typedef struct SDL_JoyHatEvent
 {
@@ -374,7 +374,7 @@ typedef struct SDL_JoyHatEvent
 } SDL_JoyHatEvent;
 
 /**
- *  \brief Joystick button event structure (event.jbutton.*)
+ *  Joystick button event structure (event.jbutton.*)
  */
 typedef struct SDL_JoyButtonEvent
 {
@@ -388,7 +388,7 @@ typedef struct SDL_JoyButtonEvent
 } SDL_JoyButtonEvent;
 
 /**
- *  \brief Joystick device event structure (event.jdevice.*)
+ *  Joystick device event structure (event.jdevice.*)
  */
 typedef struct SDL_JoyDeviceEvent
 {
@@ -398,7 +398,7 @@ typedef struct SDL_JoyDeviceEvent
 } SDL_JoyDeviceEvent;
 
 /**
- *  \brief Joysick battery level change event structure (event.jbattery.*)
+ *  Joysick battery level change event structure (event.jbattery.*)
  */
 typedef struct SDL_JoyBatteryEvent
 {
@@ -409,7 +409,7 @@ typedef struct SDL_JoyBatteryEvent
 } SDL_JoyBatteryEvent;
 
 /**
- *  \brief Gamepad axis motion event structure (event.gaxis.*)
+ *  Gamepad axis motion event structure (event.gaxis.*)
  */
 typedef struct SDL_GamepadAxisEvent
 {
@@ -426,7 +426,7 @@ typedef struct SDL_GamepadAxisEvent
 
 
 /**
- *  \brief Gamepad button event structure (event.gbutton.*)
+ *  Gamepad button event structure (event.gbutton.*)
  */
 typedef struct SDL_GamepadButtonEvent
 {
@@ -441,7 +441,7 @@ typedef struct SDL_GamepadButtonEvent
 
 
 /**
- *  \brief Gamepad device event structure (event.gdevice.*)
+ *  Gamepad device event structure (event.gdevice.*)
  */
 typedef struct SDL_GamepadDeviceEvent
 {
@@ -451,7 +451,7 @@ typedef struct SDL_GamepadDeviceEvent
 } SDL_GamepadDeviceEvent;
 
 /**
- *  \brief Gamepad touchpad event structure (event.gtouchpad.*)
+ *  Gamepad touchpad event structure (event.gtouchpad.*)
  */
 typedef struct SDL_GamepadTouchpadEvent
 {
@@ -466,7 +466,7 @@ typedef struct SDL_GamepadTouchpadEvent
 } SDL_GamepadTouchpadEvent;
 
 /**
- *  \brief Gamepad sensor event structure (event.gsensor.*)
+ *  Gamepad sensor event structure (event.gsensor.*)
  */
 typedef struct SDL_GamepadSensorEvent
 {
@@ -479,7 +479,7 @@ typedef struct SDL_GamepadSensorEvent
 } SDL_GamepadSensorEvent;
 
 /**
- *  \brief Audio device event structure (event.adevice.*)
+ *  Audio device event structure (event.adevice.*)
  */
 typedef struct SDL_AudioDeviceEvent
 {
@@ -494,7 +494,7 @@ typedef struct SDL_AudioDeviceEvent
 
 
 /**
- *  \brief Touch finger event structure (event.tfinger.*)
+ *  Touch finger event structure (event.tfinger.*)
  */
 typedef struct SDL_TouchFingerEvent
 {
@@ -513,7 +513,7 @@ typedef struct SDL_TouchFingerEvent
 
 #define SDL_DROPEVENT_DATA_SIZE 64
 /**
- *  \brief An event used to drop text or request a file open by the system (event.drop.*)
+ *  An event used to drop text or request a file open by the system (event.drop.*)
  *
  *  The `data` is owned by SDL and should be copied if the application
  *  wants to hold onto it beyond the scope of handling this event.
@@ -530,7 +530,7 @@ typedef struct SDL_DropEvent
 } SDL_DropEvent;
 
 /**
- * \brief An event triggered when the clipboard contents have changed (event.clipboard.*)
+ * An event triggered when the clipboard contents have changed (event.clipboard.*)
  */
 typedef struct SDL_ClipboardEvent
 {
@@ -539,7 +539,7 @@ typedef struct SDL_ClipboardEvent
 } SDL_ClipboardEvent;
 
 /**
- *  \brief Sensor event structure (event.sensor.*)
+ *  Sensor event structure (event.sensor.*)
  */
 typedef struct SDL_SensorEvent
 {
@@ -551,7 +551,7 @@ typedef struct SDL_SensorEvent
 } SDL_SensorEvent;
 
 /**
- *  \brief The "quit requested" event
+ *  The "quit requested" event
  */
 typedef struct SDL_QuitEvent
 {
@@ -560,7 +560,7 @@ typedef struct SDL_QuitEvent
 } SDL_QuitEvent;
 
 /**
- *  \brief OS Specific event
+ *  OS Specific event
  */
 typedef struct SDL_OSEvent
 {
@@ -569,7 +569,7 @@ typedef struct SDL_OSEvent
 } SDL_OSEvent;
 
 /**
- *  \brief A user-defined event type (event.user.*)
+ *  A user-defined event type (event.user.*)
  */
 typedef struct SDL_UserEvent
 {
@@ -586,13 +586,15 @@ struct SDL_SysWMmsg;
 typedef struct SDL_SysWMmsg SDL_SysWMmsg;
 
 /**
- *  \brief A video driver dependent system event (event.syswm.*)
+ * A video driver dependent system event (event.syswm.*)
- *         This event is disabled by default, you can enable it with SDL_SetEventEnabled()
  *
- *  The `msg` is owned by SDL and should be copied if the application
+ * This event is disabled by default, you can enable it with
- *  wants to hold onto it beyond the scope of handling this event.
+ * SDL_SetEventEnabled()
  *
- *  \note If you want to use this event, you should include SDL_syswm.h.
+ * The `msg` is owned by SDL and should be copied if the application
+ * wants to hold onto it beyond the scope of handling this event.
+ *
+ * \note If you want to use this event, you should include SDL_syswm.h.
  */
 typedef struct SDL_SysWMEvent
 {
@@ -602,7 +604,7 @@ typedef struct SDL_SysWMEvent
 } SDL_SysWMEvent;
 
 /**
- *  \brief General event structure
+ *  General event structure
  */
 typedef union SDL_Event
 {

include/SDL3/SDL_filesystem.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_filesystem.h
  *
- *  \brief Include file for filesystem SDL API functions
+ *  Include file for filesystem SDL API functions
  */
 
 #ifndef SDL_filesystem_h_

include/SDL3/SDL_gamepad.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_gamepad.h
  *
- *  \brief Include file for SDL gamepad event handling
+ *  Include file for SDL gamepad event handling
  */
 
 #ifndef SDL_gamepad_h_

include/SDL3/SDL_guid.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_guid.h
  *
- *  \brief Include file for handling ::SDL_GUID values.
+ *  Include file for handling ::SDL_GUID values.
  */
 
 #ifndef SDL_guid_h_

include/SDL3/SDL_haptic.h

@@ -22,8 +22,7 @@
 /**
  *  \file SDL_haptic.h
  *
- *  \brief The SDL haptic subsystem allows you to control haptic (force feedback)
+ *  The SDL haptic subsystem manages haptic (force feedback) devices.
- *         devices.
  *
  *  The basic usage is as follows:
  *   - Initialize the subsystem (::SDL_INIT_HAPTIC).
@@ -131,7 +130,7 @@ extern "C" {
 /**
  *  \typedef SDL_Haptic
  *
- *  \brief The haptic structure used to identify an SDL haptic.
+ *  The haptic structure used to identify an SDL haptic.
  *
  *  \sa SDL_HapticOpen
  *  \sa SDL_HapticOpenFromJoystick
@@ -154,7 +153,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 /* @{ */
 
 /**
- *  \brief Constant effect supported.
+ *  Constant effect supported.
  *
  *  Constant haptic effect.
  *
@@ -163,7 +162,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_CONSTANT   (1u<<0)
 
 /**
- *  \brief Sine wave effect supported.
+ *  Sine wave effect supported.
  *
  *  Periodic haptic effect that simulates sine waves.
  *
@@ -172,7 +171,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_SINE       (1u<<1)
 
 /**
- *  \brief Left/Right effect supported.
+ *  Left/Right effect supported.
  *
  *  Haptic effect for direct control over high/low frequency motors.
  *
@@ -186,7 +185,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 /* #define SDL_HAPTIC_SQUARE     (1<<2) */
 
 /**
- *  \brief Triangle wave effect supported.
+ *  Triangle wave effect supported.
  *
  *  Periodic haptic effect that simulates triangular waves.
  *
@@ -195,7 +194,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_TRIANGLE   (1u<<3)
 
 /**
- *  \brief Sawtoothup wave effect supported.
+ *  Sawtoothup wave effect supported.
  *
  *  Periodic haptic effect that simulates saw tooth up waves.
  *
@@ -204,7 +203,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_SAWTOOTHUP (1u<<4)
 
 /**
- *  \brief Sawtoothdown wave effect supported.
+ *  Sawtoothdown wave effect supported.
  *
  *  Periodic haptic effect that simulates saw tooth down waves.
  *
@@ -213,7 +212,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_SAWTOOTHDOWN (1u<<5)
 
 /**
- *  \brief Ramp effect supported.
+ *  Ramp effect supported.
  *
  *  Ramp haptic effect.
  *
@@ -222,7 +221,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_RAMP       (1u<<6)
 
 /**
- *  \brief Spring effect supported - uses axes position.
+ *  Spring effect supported - uses axes position.
  *
  *  Condition haptic effect that simulates a spring.  Effect is based on the
  *  axes position.
@@ -232,7 +231,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_SPRING     (1u<<7)
 
 /**
- *  \brief Damper effect supported - uses axes velocity.
+ *  Damper effect supported - uses axes velocity.
  *
  *  Condition haptic effect that simulates dampening.  Effect is based on the
  *  axes velocity.
@@ -242,7 +241,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_DAMPER     (1u<<8)
 
 /**
- *  \brief Inertia effect supported - uses axes acceleration.
+ *  Inertia effect supported - uses axes acceleration.
  *
  *  Condition haptic effect that simulates inertia.  Effect is based on the axes
  *  acceleration.
@@ -252,7 +251,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_INERTIA    (1u<<9)
 
 /**
- *  \brief Friction effect supported - uses axes movement.
+ *  Friction effect supported - uses axes movement.
  *
  *  Condition haptic effect that simulates friction.  Effect is based on the
  *  axes movement.
@@ -262,7 +261,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_FRICTION   (1u<<10)
 
 /**
- *  \brief Custom effect is supported.
+ *  Custom effect is supported.
  *
  *  User defined custom haptic effect.
  */
@@ -273,7 +272,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 /* These last few are features the device has, not effects */
 
 /**
- *  \brief Device can set global gain.
+ *  Device can set global gain.
  *
  *  Device supports setting the global gain.
  *
@@ -282,7 +281,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_GAIN       (1u<<12)
 
 /**
- *  \brief Device can set autocenter.
+ *  Device can set autocenter.
  *
  *  Device supports setting autocenter.
  *
@@ -291,7 +290,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_AUTOCENTER (1u<<13)
 
 /**
- *  \brief Device can be queried for effect status.
+ *  Device can be queried for effect status.
  *
  *  Device supports querying effect status.
  *
@@ -300,7 +299,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 #define SDL_HAPTIC_STATUS     (1u<<14)
 
 /**
- *  \brief Device can be paused.
+ *  Device can be paused.
  *
  *  Devices supports being paused.
  *
@@ -316,31 +315,33 @@ typedef struct SDL_Haptic SDL_Haptic;
 /* @{ */
 
 /**
- *  \brief Uses polar coordinates for the direction.
+ *  Uses polar coordinates for the direction.
  *
  *  \sa SDL_HapticDirection
  */
 #define SDL_HAPTIC_POLAR      0
 
 /**
- *  \brief Uses cartesian coordinates for the direction.
+ *  Uses cartesian coordinates for the direction.
  *
  *  \sa SDL_HapticDirection
  */
 #define SDL_HAPTIC_CARTESIAN  1
 
 /**
- *  \brief Uses spherical coordinates for the direction.
+ *  Uses spherical coordinates for the direction.
  *
  *  \sa SDL_HapticDirection
  */
 #define SDL_HAPTIC_SPHERICAL  2
 
 /**
- *  \brief Use this value to play an effect on the steering wheel axis. This 
+ * Use this value to play an effect on the steering wheel axis.
- *  provides better compatibility across platforms and devices as SDL will guess 
+ *
- *  the correct axis.
+ * This provides better compatibility across platforms and devices as SDL
- *  \sa SDL_HapticDirection
+ * will guess the correct axis.
+ *
+ * \sa SDL_HapticDirection
  */
 #define SDL_HAPTIC_STEERING_AXIS 3
 
@@ -353,7 +354,7 @@ typedef struct SDL_Haptic SDL_Haptic;
  */
 
 /**
- * \brief Used to play a device an infinite number of times.
+ * Used to play a device an infinite number of times.
  *
  * \sa SDL_HapticRunEffect
  */
@@ -361,7 +362,7 @@ typedef struct SDL_Haptic SDL_Haptic;
 
 
 /**
- *  \brief Structure that represents a haptic direction.
+ *  Structure that represents a haptic direction.
  *
  *  This is the direction where the force comes from,
  *  instead of the direction in which the force is exerted.
@@ -464,7 +465,7 @@ typedef struct SDL_HapticDirection
 
 
 /**
- *  \brief A structure containing a template for a Constant effect.
+ *  A structure containing a template for a Constant effect.
  *
  *  This struct is exclusively for the ::SDL_HAPTIC_CONSTANT effect.
  *
@@ -499,7 +500,7 @@ typedef struct SDL_HapticConstant
 } SDL_HapticConstant;
 
 /**
- *  \brief A structure containing a template for a Periodic effect.
+ *  A structure containing a template for a Periodic effect.
  *
  *  The struct handles the following effects:
  *   - ::SDL_HAPTIC_SINE
@@ -585,7 +586,7 @@ typedef struct SDL_HapticPeriodic
 } SDL_HapticPeriodic;
 
 /**
- *  \brief A structure containing a template for a Condition effect.
+ *  A structure containing a template for a Condition effect.
  *
  *  The struct handles the following effects:
  *   - ::SDL_HAPTIC_SPRING: Effect based on axes position.
@@ -633,7 +634,7 @@ typedef struct SDL_HapticCondition
 } SDL_HapticCondition;
 
 /**
- *  \brief A structure containing a template for a Ramp effect.
+ *  A structure containing a template for a Ramp effect.
  *
  *  This struct is exclusively for the ::SDL_HAPTIC_RAMP effect.
  *
@@ -671,7 +672,7 @@ typedef struct SDL_HapticRamp
 } SDL_HapticRamp;
 
 /**
- * \brief A structure containing a template for a Left/Right effect.
+ * A structure containing a template for a Left/Right effect.
  *
  * This struct is exclusively for the ::SDL_HAPTIC_LEFTRIGHT effect.
  *
@@ -696,7 +697,7 @@ typedef struct SDL_HapticLeftRight
 } SDL_HapticLeftRight;
 
 /**
- *  \brief A structure containing a template for the ::SDL_HAPTIC_CUSTOM effect.
+ *  A structure containing a template for the ::SDL_HAPTIC_CUSTOM effect.
  *
  *  This struct is exclusively for the ::SDL_HAPTIC_CUSTOM effect.
  *
@@ -738,7 +739,7 @@ typedef struct SDL_HapticCustom
 } SDL_HapticCustom;
 
 /**
- *  \brief The generic template for any haptic effect.
+ *  The generic template for any haptic effect.
  *
  *  All values max at 32767 (0x7FFF).  Signed values also can be negative.
  *  Time values unless specified otherwise are in milliseconds.

include/SDL3/SDL_hidapi.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_hidapi.h
  *
- *  \brief Header file for SDL HIDAPI functions.
+ *  Header file for SDL HIDAPI functions.
  *
  *  This is an adaptation of the original HIDAPI interface by Alan Ott,
  *  and includes source code licensed under the following BSD license:
@@ -71,13 +71,13 @@ extern "C" {
 #endif
 
 /**
- *  \brief  A handle representing an open HID device
+ *  A handle representing an open HID device
  */
 struct SDL_hid_device_;
 typedef struct SDL_hid_device_ SDL_hid_device; /**< opaque hidapi structure */
 
 /**
- *  \brief HID underlying bus types.
+ *  HID underlying bus types.
  */
 typedef enum {
     /** Unknown bus type */
@@ -109,7 +109,7 @@ typedef enum {
 
 /** hidapi info structure */
 /**
- *  \brief  Information about a connected HID device
+ *  Information about a connected HID device
  */
 typedef struct SDL_hid_device_info
 {

include/SDL3/SDL_init.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_init.h
  *
- *  \brief Init and quit header for the SDL library
+ *  Init and quit header for the SDL library
  */
 
 #ifndef SDL_init_h_
@@ -39,7 +39,7 @@ extern "C" {
 /* As of version 0.5, SDL is loaded dynamically into the application */
 
 /**
- *   \brief Initialization flags for SDL_Init and/or SDL_InitSubSystem
+ *   Initialization flags for SDL_Init and/or SDL_InitSubSystem
  *
  * These are the flags which may be passed to SDL_Init().  You should
  * specify the subsystems which you will be using in your application.

include/SDL3/SDL_intrin.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_intrin.h
  *
- *  \brief Header file for CPU intrinsics for SDL
+ *  Header file for CPU intrinsics for SDL
  */
 
 #ifndef SDL_intrin_h_

include/SDL3/SDL_joystick.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_joystick.h
  *
- *  \brief Include file for SDL joystick event handling
+ *  Include file for SDL joystick event handling
  *
  *  The term "instance_id" is the current instantiation of a joystick device in the system, if the joystick is removed and then re-inserted
  *    then it will get a new instance_id, instance_id's are monotonically increasing identifiers of a joystick plugged in.
@@ -359,7 +359,7 @@ typedef struct SDL_VirtualJoystickDesc
 } SDL_VirtualJoystickDesc;
 
 /**
- * \brief The current version of the SDL_VirtualJoystickDesc structure
+ * The current version of the SDL_VirtualJoystickDesc structure
  */
 #define SDL_VIRTUAL_JOYSTICK_DESC_VERSION   1
 

include/SDL3/SDL_keyboard.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_keyboard.h
  *
- *  \brief Include file for SDL keyboard event handling
+ *  Include file for SDL keyboard event handling
  */
 
 #ifndef SDL_keyboard_h_
@@ -40,7 +40,7 @@ extern "C" {
 #endif
 
 /**
- *  \brief The SDL keysym structure, used in key events.
+ *  The SDL keysym structure, used in key events.
  *
  *  \note  If you are looking for translated character input, see the ::SDL_EVENT_TEXT_INPUT event.
  */

include/SDL3/SDL_keycode.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_keycode.h
  *
- *  \brief Defines constants which identify keyboard keys and modifiers.
+ *  Defines constants which identify keyboard keys and modifiers.
  */
 
 #ifndef SDL_keycode_h_
@@ -32,7 +32,7 @@
 #include <SDL3/SDL_scancode.h>
 
 /**
- *  \brief The SDL virtual key representation.
+ *  The SDL virtual key representation.
  *
  *  Values of this type are used to represent keyboard keys using the current
  *  layout of the keyboard.  These values include Unicode values representing
@@ -327,7 +327,7 @@ typedef enum
 } SDL_KeyCode;
 
 /**
- * \brief Enumeration of valid key mods (possibly OR'd together).
+ * Enumeration of valid key mods (possibly OR'd together).
  */
 typedef enum
 {

include/SDL3/SDL_loadso.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_loadso.h
  *
- *  \brief System dependent library loading routines
+ *  System dependent library loading routines
  *
  *  Some things to keep in mind:
  *  \li These functions only work on C function names.  Other languages may

include/SDL3/SDL_locale.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_locale.h
  *
- *  \brief Include file for SDL locale services
+ *  Include file for SDL locale services
  */
 
 #ifndef SDL_locale_h

include/SDL3/SDL_log.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_log.h
  *
- *  \brief Simple log messages with categories and priorities.
+ *  Simple log messages with categories and priorities.
  *
  *  By default logs are quiet, but if you're debugging SDL you might want:
  *
@@ -47,14 +47,14 @@ extern "C" {
 
 
 /**
- *  \brief The maximum size of a log message prior to SDL 2.0.24
+ *  The maximum size of a log message prior to SDL 2.0.24
  *
  *  As of 2.0.24 there is no limit to the length of SDL log messages.
  */
 #define SDL_MAX_LOG_MESSAGE 4096
 
 /**
- *  \brief The predefined log categories
+ *  The predefined log categories
  *
  *  By default the application category is enabled at the INFO level,
  *  the assert category is enabled at the WARN level, test is enabled
@@ -97,7 +97,7 @@ typedef enum
 } SDL_LogCategory;
 
 /**
- *  \brief The predefined log priorities
+ *  The predefined log priorities
  */
 typedef enum
 {

include/SDL3/SDL_main.h

@@ -35,7 +35,7 @@
 /**
  *  \file SDL_main.h
  *
- *  \brief Redefine main() on some platforms so that it is called by SDL.
+ *  Redefine main() on some platforms so that it is called by SDL.
  */
 
 #ifndef SDL_MAIN_HANDLED

include/SDL3/SDL_metal.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_metal.h
  *
- *  \brief Header file for functions to creating Metal layers and views on SDL windows.
+ *  Header file for functions to creating Metal layers and views on SDL windows.
  */
 
 #ifndef SDL_metal_h_
@@ -37,7 +37,7 @@ extern "C" {
 #endif
 
 /**
- *  \brief A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
+ *  A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
  *
  *  \note This can be cast directly to an NSView or UIView.
  */

include/SDL3/SDL_misc.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_misc.h
  *
- *  \brief Include file for SDL API functions that don't fit elsewhere.
+ *  Include file for SDL API functions that don't fit elsewhere.
  */
 
 #ifndef SDL_misc_h_

include/SDL3/SDL_mouse.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_mouse.h
  *
- *  \brief Include file for SDL mouse event handling.
+ *  Include file for SDL mouse event handling.
  */
 
 #ifndef SDL_mouse_h_
@@ -43,7 +43,7 @@ typedef Uint32 SDL_MouseID;
 typedef struct SDL_Cursor SDL_Cursor;   /**< Implementation dependent */
 
 /**
- * \brief Cursor types for SDL_CreateSystemCursor().
+ * Cursor types for SDL_CreateSystemCursor().
  */
 typedef enum
 {
@@ -63,7 +63,7 @@ typedef enum
 } SDL_SystemCursor;
 
 /**
- * \brief Scroll direction types for the Scroll event
+ * Scroll direction types for the Scroll event
  */
 typedef enum
 {

include/SDL3/SDL_mutex.h

@@ -25,7 +25,7 @@
 /**
  *  \file SDL_mutex.h
  *
- *  \brief Functions to provide thread synchronization primitives.
+ *  Functions to provide thread synchronization primitives.
  */
 
 #include <SDL3/SDL_stdinc.h>

include/SDL3/SDL_oldnames.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_oldnames.h
  *
- *  \brief Definitions to ease transition from SDL2 code
+ *  Definitions to ease transition from SDL2 code
  */
 
 #ifndef SDL_oldnames_h_

include/SDL3/SDL_opengl.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_opengl.h
  *
- *  \brief This is a simple file to encapsulate the OpenGL API headers.
+ *  This is a simple file to encapsulate the OpenGL API headers.
  */
 
 /**

include/SDL3/SDL_opengles.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_opengles.h
  *
- *  \brief This is a simple file to encapsulate the OpenGL ES 1.X API headers.
+ *  This is a simple file to encapsulate the OpenGL ES 1.X API headers.
  */
 #include <SDL3/SDL_platform_defines.h>
 

include/SDL3/SDL_opengles2.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_opengles2.h
  *
- *  \brief This is a simple file to encapsulate the OpenGL ES 2.0 API headers.
+ *  This is a simple file to encapsulate the OpenGL ES 2.0 API headers.
  */
 #include <SDL3/SDL_platform_defines.h>
 

include/SDL3/SDL_pixels.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_pixels.h
  *
- *  \brief Header for the enumerated pixel format definitions.
+ *  Header for the enumerated pixel format definitions.
  *
  *  SDL's pixel formats have the following naming convention:
  *

include/SDL3/SDL_platform.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_platform.h
  *
- *  \brief Header file for platform functions.
+ *  Header file for platform functions.
  */
 
 #ifndef SDL_platform_h_

include/SDL3/SDL_platform_defines.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_platform_defines.h
  *
- *  \brief Try to get a standard set of platform defines.
+ *  Try to get a standard set of platform defines.
  */
 
 #ifndef SDL_platform_defines_h_

include/SDL3/SDL_power.h

@@ -25,7 +25,7 @@
 /**
  *  \file SDL_power.h
  *
- *  \brief Header for the SDL power management routines.
+ *  Header for the SDL power management routines.
  */
 
 #include <SDL3/SDL_stdinc.h>

include/SDL3/SDL_properties.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_properties.h
  *
- *  \brief Header file for SDL properties.
+ *  Header file for SDL properties.
  */
 
 #ifndef SDL_properties_h_

include/SDL3/SDL_quit.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_quit.h
  *
- *  \brief Include file for SDL quit event handling.
+ *  Include file for SDL quit event handling.
  */
 
 #ifndef SDL_quit_h_

include/SDL3/SDL_rect.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_rect.h
  *
- *  \brief Header file for SDL_rect definition and management functions.
+ *  Header file for SDL_rect definition and management functions.
  */
 
 #ifndef SDL_rect_h_

include/SDL3/SDL_render.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_render.h
  *
- *  \brief Header file for SDL 2D rendering functions.
+ *  Header file for SDL 2D rendering functions.
  *
  *  This API supports the following features:
  *      * single pixel points

include/SDL3/SDL_revision.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_revision.h
  *
- *  \brief Header file containing the SDL revision
+ *  Header file containing the SDL revision
  */
 
 #ifndef SDL_revision_h_

include/SDL3/SDL_scancode.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_scancode.h
  *
- *  \brief Defines keyboard scancodes.
+ *  Defines keyboard scancodes.
  */
 
 #ifndef SDL_scancode_h_
@@ -31,7 +31,7 @@
 #include <SDL3/SDL_stdinc.h>
 
 /**
- *  \brief The SDL keyboard scancode representation.
+ *  The SDL keyboard scancode representation.
  *
  *  Values of this type are used to represent keyboard keys, among other places
  *  in the \link SDL_Keysym::scancode key.keysym.scancode \endlink field of the

include/SDL3/SDL_sensor.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_sensor.h
  *
- *  \brief Include file for SDL sensor event handling
+ *  Include file for SDL sensor event handling
  */
 
 #ifndef SDL_sensor_h_
@@ -41,7 +41,7 @@ extern "C" {
 #endif
 
 /**
- *  \brief SDL_sensor.h
+ *  SDL_sensor.h
  *
  *  In order to use these functions, SDL_Init() must have been called
  *  with the ::SDL_INIT_SENSOR flag.  This causes SDL to scan the system

include/SDL3/SDL_shape.h

@@ -36,7 +36,7 @@ extern "C" {
 
 /** \file SDL_shape.h
  *
- *  \brief Header file for the shaped window API.
+ *  Header file for the shaped window API.
  */
 
 #define SDL_NONSHAPEABLE_WINDOW -1
@@ -76,32 +76,32 @@ extern DECLSPEC SDL_Window *SDLCALL SDL_CreateShapedWindow(const char *title, in
  */
 extern DECLSPEC SDL_bool SDLCALL SDL_IsShapedWindow(const SDL_Window *window);
 
-/** \brief An enum denoting the specific type of contents present in an SDL_WindowShapeParams union. */
+/** An enum denoting the specific type of contents present in an SDL_WindowShapeParams union. */
 typedef enum {
-    /** \brief The default mode, a binarized alpha cutoff of 1. */
+    /** The default mode, a binarized alpha cutoff of 1. */
     ShapeModeDefault,
-    /** \brief A binarized alpha cutoff with a given integer value. */
+    /** A binarized alpha cutoff with a given integer value. */
     ShapeModeBinarizeAlpha,
-    /** \brief A binarized alpha cutoff with a given integer value, but with the opposite comparison. */
+    /** A binarized alpha cutoff with a given integer value, but with the opposite comparison. */
     ShapeModeReverseBinarizeAlpha,
-    /** \brief A color key is applied. */
+    /** A color key is applied. */
     ShapeModeColorKey
 } WindowShapeMode;
 
 #define SDL_SHAPEMODEALPHA(mode) (mode == ShapeModeDefault || mode == ShapeModeBinarizeAlpha || mode == ShapeModeReverseBinarizeAlpha)
 
-/** \brief A union containing parameters for shaped windows. */
+/** A union containing parameters for shaped windows. */
 typedef union {
-    /** \brief A cutoff alpha value for binarization of the window shape's alpha channel. */
+    /** A cutoff alpha value for binarization of the window shape's alpha channel. */
     Uint8 binarizationCutoff;
     SDL_Color colorKey;
 } SDL_WindowShapeParams;
 
-/** \brief A struct that tags the SDL_WindowShapeParams union with an enum describing the type of its contents. */
+/** A struct that tags the SDL_WindowShapeParams union with an enum describing the type of its contents. */
 typedef struct SDL_WindowShapeMode {
-    /** \brief The mode of these window-shape parameters. */
+    /** The mode of these window-shape parameters. */
     WindowShapeMode mode;
-    /** \brief Window-shape parameters. */
+    /** Window-shape parameters. */
     SDL_WindowShapeParams parameters;
 } SDL_WindowShapeMode;
 

include/SDL3/SDL_stdinc.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_stdinc.h
  *
- *  \brief This is a general header that includes C language support.
+ *  This is a general header that includes C language support.
  */
 
 #ifndef SDL_stdinc_h_
@@ -123,57 +123,57 @@ char *alloca();
 /* @{ */
 
 /**
- * \brief A boolean type.
+ * A boolean type.
  */
 #define SDL_FALSE 0
 #define SDL_TRUE 1
 typedef unsigned int SDL_bool;
 
 /**
- * \brief A signed 8-bit integer type.
+ * A signed 8-bit integer type.
  */
 #define SDL_MAX_SINT8   ((Sint8)0x7F)           /* 127 */
 #define SDL_MIN_SINT8   ((Sint8)(~0x7F))        /* -128 */
 typedef int8_t Sint8;
 /**
- * \brief An unsigned 8-bit integer type.
+ * An unsigned 8-bit integer type.
  */
 #define SDL_MAX_UINT8   ((Uint8)0xFF)           /* 255 */
 #define SDL_MIN_UINT8   ((Uint8)0x00)           /* 0 */
 typedef uint8_t Uint8;
 /**
- * \brief A signed 16-bit integer type.
+ * A signed 16-bit integer type.
  */
 #define SDL_MAX_SINT16  ((Sint16)0x7FFF)        /* 32767 */
 #define SDL_MIN_SINT16  ((Sint16)(~0x7FFF))     /* -32768 */
 typedef int16_t Sint16;
 /**
- * \brief An unsigned 16-bit integer type.
+ * An unsigned 16-bit integer type.
  */
 #define SDL_MAX_UINT16  ((Uint16)0xFFFF)        /* 65535 */
 #define SDL_MIN_UINT16  ((Uint16)0x0000)        /* 0 */
 typedef uint16_t Uint16;
 /**
- * \brief A signed 32-bit integer type.
+ * A signed 32-bit integer type.
  */
 #define SDL_MAX_SINT32  ((Sint32)0x7FFFFFFF)    /* 2147483647 */
 #define SDL_MIN_SINT32  ((Sint32)(~0x7FFFFFFF)) /* -2147483648 */
 typedef int32_t Sint32;
 /**
- * \brief An unsigned 32-bit integer type.
+ * An unsigned 32-bit integer type.
  */
 #define SDL_MAX_UINT32  ((Uint32)0xFFFFFFFFu)   /* 4294967295 */
 #define SDL_MIN_UINT32  ((Uint32)0x00000000)    /* 0 */
 typedef uint32_t Uint32;
 
 /**
- * \brief A signed 64-bit integer type.
+ * A signed 64-bit integer type.
  */
 #define SDL_MAX_SINT64  ((Sint64)0x7FFFFFFFFFFFFFFFll)      /* 9223372036854775807 */
 #define SDL_MIN_SINT64  ((Sint64)(~0x7FFFFFFFFFFFFFFFll))   /* -9223372036854775808 */
 typedef int64_t Sint64;
 /**
- * \brief An unsigned 64-bit integer type.
+ * An unsigned 64-bit integer type.
  */
 #define SDL_MAX_UINT64  ((Uint64)0xFFFFFFFFFFFFFFFFull)     /* 18446744073709551615 */
 #define SDL_MIN_UINT64  ((Uint64)(0x0000000000000000ull))   /* 0 */

include/SDL3/SDL_surface.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_surface.h
  *
- *  \brief Header file for ::SDL_Surface definition and management functions.
+ *  Header file for ::SDL_Surface definition and management functions.
  */
 
 #ifndef SDL_surface_h_
@@ -65,7 +65,7 @@ extern "C" {
 typedef struct SDL_BlitMap SDL_BlitMap;  /* this is an opaque type. */
 
 /**
- * \brief A collection of pixels used in software blitting.
+ * A collection of pixels used in software blitting.
  *
  * Pixels are arranged in memory in rows, with the top row first.
  * Each row occupies an amount of memory given by the pitch (sometimes
@@ -112,13 +112,13 @@ typedef struct SDL_Surface
 } SDL_Surface;
 
 /**
- * \brief The type of function used for surface blitting functions.
+ * The type of function used for surface blitting functions.
  */
 typedef int (SDLCALL *SDL_blit) (struct SDL_Surface *src, const SDL_Rect *srcrect,
                                  struct SDL_Surface *dst, const SDL_Rect *dstrect);
 
 /**
- * \brief The formula used for converting between YUV and RGB
+ * The formula used for converting between YUV and RGB
  */
 typedef enum
 {

include/SDL3/SDL_system.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_system.h
  *
- *  \brief Include file for platform specific SDL API functions
+ *  Include file for platform specific SDL API functions
  */
 
 #ifndef SDL_system_h_
@@ -475,44 +475,44 @@ extern DECLSPEC int SDLCALL SDL_AndroidSendMessage(Uint32 command, int param);
 #ifdef __WINRT__
 
 /**
- *  \brief WinRT / Windows Phone path types
+ *  WinRT / Windows Phone path types
  */
 typedef enum
 {
-    /** \brief The installed app's root directory.
+    /** The installed app's root directory.
         Files here are likely to be read-only. */
     SDL_WINRT_PATH_INSTALLED_LOCATION,
 
-    /** \brief The app's local data store.  Files may be written here */
+    /** The app's local data store.  Files may be written here */
     SDL_WINRT_PATH_LOCAL_FOLDER,
 
-    /** \brief The app's roaming data store.  Unsupported on Windows Phone.
+    /** The app's roaming data store.  Unsupported on Windows Phone.
         Files written here may be copied to other machines via a network
         connection.
     */
     SDL_WINRT_PATH_ROAMING_FOLDER,
 
-    /** \brief The app's temporary data store.  Unsupported on Windows Phone.
+    /** The app's temporary data store.  Unsupported on Windows Phone.
         Files written here may be deleted at any time. */
     SDL_WINRT_PATH_TEMP_FOLDER
 } SDL_WinRT_Path;
 
 
 /**
- *  \brief WinRT Device Family
+ *  WinRT Device Family
  */
 typedef enum
 {
-    /** \brief Unknown family  */
+    /** Unknown family  */
     SDL_WINRT_DEVICEFAMILY_UNKNOWN,
 
-    /** \brief Desktop family*/
+    /** Desktop family*/
     SDL_WINRT_DEVICEFAMILY_DESKTOP,
 
-    /** \brief Mobile family (for example smartphone) */
+    /** Mobile family (for example smartphone) */
     SDL_WINRT_DEVICEFAMILY_MOBILE,
 
-    /** \brief XBox family */
+    /** XBox family */
     SDL_WINRT_DEVICEFAMILY_XBOX,
 } SDL_WinRT_DeviceFamily;
 

include/SDL3/SDL_syswm.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_syswm.h
  *
- *  \brief Include file for SDL custom system window manager hooks.
+ *  Include file for SDL custom system window manager hooks.
  */
 
 #ifndef SDL_syswm_h_
@@ -34,7 +34,7 @@
 #include <SDL3/SDL_video.h>
 
 /**
- *  \brief SDL_syswm.h
+ *  SDL_syswm.h
  *
  *  Your application has access to a special type of event ::SDL_EVENT_SYSWM,
  *  which contains window-manager specific information and arrives whenever

include/SDL3/SDL_test.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test.h
  *
- *  \brief Include file for SDL test framework.
+ *  Include file for SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */

include/SDL3/SDL_test_assert.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_assert.h
  *
- *  \brief Assertion functions of SDL test framework.
+ *  Assertion functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -43,17 +43,17 @@ extern "C" {
 #endif
 
 /**
- * \brief Fails the assert.
+ * Fails the assert.
  */
 #define ASSERT_FAIL     0
 
 /**
- * \brief Passes the assert.
+ * Passes the assert.
  */
 #define ASSERT_PASS     1
 
 /**
- * \brief Assert that logs and break execution flow on failures.
+ * Assert that logs and break execution flow on failures.
  *
  * \param assertCondition Evaluated condition or variable to assert; fail (==0) or pass (!=0).
  * \param assertDescription Message to log with the assert describing it.
@@ -61,7 +61,7 @@ extern "C" {
 void SDLTest_Assert(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2);
 
 /**
- * \brief Assert for test cases that logs but does not break execution flow on failures. Updates assertion counters.
+ * Assert for test cases that logs but does not break execution flow on failures. Updates assertion counters.
  *
  * \param assertCondition Evaluated condition or variable to assert; fail (==0) or pass (!=0).
  * \param assertDescription Message to log with the assert describing it.
@@ -71,25 +71,25 @@ void SDLTest_Assert(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *as
 int SDLTest_AssertCheck(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2);
 
 /**
- * \brief Explicitly pass without checking an assertion condition. Updates assertion counter.
+ * Explicitly pass without checking an assertion condition. Updates assertion counter.
  *
  * \param assertDescription Message to log with the assert describing it.
  */
 void SDLTest_AssertPass(SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(1);
 
 /**
- * \brief Resets the assert summary counters to zero.
+ * Resets the assert summary counters to zero.
  */
 void SDLTest_ResetAssertSummary(void);
 
 /**
- * \brief Logs summary of all assertions (total, pass, fail) since last reset as INFO or ERROR.
+ * Logs summary of all assertions (total, pass, fail) since last reset as INFO or ERROR.
  */
 void SDLTest_LogAssertSummary(void);
 
 
 /**
- * \brief Converts the current assert summary state to a test result.
+ * Converts the current assert summary state to a test result.
  *
  * \returns TEST_RESULT_PASSED, TEST_RESULT_FAILED, or TEST_RESULT_NO_ASSERT
  */

include/SDL3/SDL_test_common.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_common.h
  *
- *  \brief Common functions of SDL test framework.
+ *  Common functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -139,7 +139,7 @@ extern "C" {
 /* Function prototypes */
 
 /**
- * \brief Parse command line parameters and create common state.
+ * Parse command line parameters and create common state.
  *
  * \param argv Array of command line parameters
  * \param flags Flags indicating which subsystem to initialize (i.e. SDL_INIT_VIDEO | SDL_INIT_AUDIO)
@@ -149,14 +149,14 @@ extern "C" {
 SDLTest_CommonState *SDLTest_CommonCreateState(char **argv, Uint32 flags);
 
 /**
- * \brief Free the common state object.
+ * Free the common state object.
  *
  * \param state The common state object to destroy
  */
 void SDLTest_CommonDestroyState(SDLTest_CommonState *state);
 
 /**
- * \brief Process one common argument.
+ * Process one common argument.
  *
  * \param state The common state describing the test window to create.
  * \param index The index of the argument to process in argv[].
@@ -167,7 +167,7 @@ int SDLTest_CommonArg(SDLTest_CommonState *state, int index);
 
 
 /**
- * \brief Logs command line usage info.
+ * Logs command line usage info.
  *
  * This logs the appropriate command line options for the subsystems in use
  *  plus other common options, and then any application-specific options.
@@ -181,7 +181,7 @@ int SDLTest_CommonArg(SDLTest_CommonState *state, int index);
 void SDLTest_CommonLogUsage(SDLTest_CommonState *state, const char *argv0, const char **options);
 
 /**
- * \brief Open test window.
+ * Open test window.
  *
  * \param state The common state describing the test window to create.
  *
@@ -190,7 +190,7 @@ void SDLTest_CommonLogUsage(SDLTest_CommonState *state, const char *argv0, const
 SDL_bool SDLTest_CommonInit(SDLTest_CommonState *state);
 
 /**
- * \brief Easy argument handling when test app doesn't need any custom args.
+ * Easy argument handling when test app doesn't need any custom args.
  *
  * \param state The common state describing the test window to create.
  * \param argc argc, as supplied to SDL_main
@@ -223,7 +223,7 @@ void SDLTest_CommonEvent(SDLTest_CommonState *state, SDL_Event *event, int *done
 int SDLTest_CommonEventMainCallbacks(SDLTest_CommonState *state, const SDL_Event *event);
 
 /**
- * \brief Close test window.
+ * Close test window.
  *
  * \param state The common state used to create test window.
  *
@@ -231,7 +231,7 @@ int SDLTest_CommonEventMainCallbacks(SDLTest_CommonState *state, const SDL_Event
 void SDLTest_CommonQuit(SDLTest_CommonState *state);
 
 /**
- * \brief Draws various window information (position, size, etc.) to the renderer.
+ * Draws various window information (position, size, etc.) to the renderer.
  *
  * \param renderer The renderer to draw to.
  * \param window The window whose information should be displayed.

include/SDL3/SDL_test_compare.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_compare.h
  *
- *  \brief Comparison function of SDL test framework.
+ *  Comparison function of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -45,7 +45,7 @@ extern "C" {
 #endif
 
 /**
- * \brief Retrieves a single pixel from a surface.
+ * Retrieves a single pixel from a surface.
  *
  * This function prioritizes correctness over speed: it is suitable for
  * unit tests, but is not intended for use in a game engine.
@@ -66,7 +66,7 @@ extern "C" {
 int SDLTest_ReadSurfacePixel(SDL_Surface *surface, int x, int y, Uint8 *r, Uint8 *g, Uint8 *b, Uint8 *a);
 
 /**
- * \brief Compares a surface and with reference image data for equality
+ * Compares a surface and with reference image data for equality
  *
  * \param surface Surface used in comparison
  * \param referenceSurface Test Surface used in comparison

include/SDL3/SDL_test_crc32.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_crc32.h
  *
- *  \brief CRC32 functions of SDL test framework.
+ *  CRC32 functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -70,7 +70,7 @@ extern "C" {
 /* ---------- Function Prototypes ------------- */
 
 /**
- * \brief Initialize the CRC context
+ * Initialize the CRC context
  *
  * Note: The function initializes the crc table required for all crc calculations.
  *
@@ -83,7 +83,7 @@ extern "C" {
 
 
 /**
- * \brief calculate a crc32 from a data block
+ * calculate a crc32 from a data block
  *
  * \param crcContext         pointer to context variable
  * \param inBuf              input buffer to checksum
@@ -102,7 +102,7 @@ int SDLTest_Crc32CalcBuffer(SDLTest_Crc32Context *crcContext, CrcUint8 *inBuf, C
 
 
 /**
- * \brief clean up CRC context
+ * clean up CRC context
  *
  * \param crcContext        pointer to context variable
  *

include/SDL3/SDL_test_font.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_font.h
  *
- *  \brief Font related functions of SDL test framework.
+ *  Font related functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -43,7 +43,7 @@ extern int FONT_CHARACTER_SIZE;
 #define FONT_LINE_HEIGHT    (FONT_CHARACTER_SIZE + 2)
 
 /**
- *  \brief Draw a string in the currently set font.
+ *  Draw a string in the currently set font.
  *
  *  \param renderer The renderer to draw on.
  *  \param x The X coordinate of the upper left corner of the character.
@@ -55,7 +55,7 @@ extern int FONT_CHARACTER_SIZE;
 int SDLTest_DrawCharacter(SDL_Renderer *renderer, float x, float y, Uint32 c);
 
 /**
- *  \brief Draw a UTF-8 string in the currently set font.
+ *  Draw a UTF-8 string in the currently set font.
  *
  *  The font currently only supports characters in the Basic Latin and Latin-1 Supplement sets.
  *
@@ -69,7 +69,7 @@ int SDLTest_DrawCharacter(SDL_Renderer *renderer, float x, float y, Uint32 c);
 int SDLTest_DrawString(SDL_Renderer *renderer, float x, float y, const char *s);
 
 /**
- *  \brief Data used for multi-line text output
+ *  Data used for multi-line text output
  */
 typedef struct SDLTest_TextWindow
 {
@@ -80,7 +80,7 @@ typedef struct SDLTest_TextWindow
 } SDLTest_TextWindow;
 
 /**
- *  \brief Create a multi-line text output window
+ *  Create a multi-line text output window
  *
  *  \param x The X coordinate of the upper left corner of the window.
  *  \param y The Y coordinate of the upper left corner of the window.
@@ -94,7 +94,7 @@ typedef struct SDLTest_TextWindow
 SDLTest_TextWindow *SDLTest_TextWindowCreate(float x, float y, float w, float h);
 
 /**
- *  \brief Display a multi-line text output window
+ *  Display a multi-line text output window
  *
  *  This function should be called every frame to display the text
  *
@@ -106,7 +106,7 @@ SDLTest_TextWindow *SDLTest_TextWindowCreate(float x, float y, float w, float h)
 void SDLTest_TextWindowDisplay(SDLTest_TextWindow *textwin, SDL_Renderer *renderer);
 
 /**
- *  \brief Add text to a multi-line text output window
+ *  Add text to a multi-line text output window
  *
  *  Adds UTF-8 text to the end of the current text. The newline character starts a
  *  new line of text. The backspace character deletes the last character or, if the
@@ -121,7 +121,7 @@ void SDLTest_TextWindowDisplay(SDLTest_TextWindow *textwin, SDL_Renderer *render
 void SDLTest_TextWindowAddText(SDLTest_TextWindow *textwin, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
 
 /**
- *  \brief Add text to a multi-line text output window
+ *  Add text to a multi-line text output window
  *
  *  Adds UTF-8 text to the end of the current text. The newline character starts a
  *  new line of text. The backspace character deletes the last character or, if the
@@ -136,7 +136,7 @@ void SDLTest_TextWindowAddText(SDLTest_TextWindow *textwin, SDL_PRINTF_FORMAT_ST
 void SDLTest_TextWindowAddTextWithLength(SDLTest_TextWindow *textwin, const char *text, size_t len);
 
 /**
- *  \brief Clear the text in a multi-line text output window
+ *  Clear the text in a multi-line text output window
  *
  *  \param textwin The text output window
  *
@@ -145,7 +145,7 @@ void SDLTest_TextWindowAddTextWithLength(SDLTest_TextWindow *textwin, const char
 void SDLTest_TextWindowClear(SDLTest_TextWindow *textwin);
 
 /**
- *  \brief Free the storage associated with a multi-line text output window
+ *  Free the storage associated with a multi-line text output window
  *
  *  \param textwin The text output window
  *
@@ -154,7 +154,7 @@ void SDLTest_TextWindowClear(SDLTest_TextWindow *textwin);
 void SDLTest_TextWindowDestroy(SDLTest_TextWindow *textwin);
 
 /**
- *  \brief Cleanup textures used by font drawing functions.
+ *  Cleanup textures used by font drawing functions.
  */
 void SDLTest_CleanupTextDrawing(void);
 

include/SDL3/SDL_test_fuzzer.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_fuzzer.h
  *
- *  \brief Fuzzer functions of SDL test framework.
+ *  Fuzzer functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */

include/SDL3/SDL_test_harness.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_harness.h
  *
- *  \brief Test suite related functions of SDL test framework.
+ *  Test suite related functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -99,7 +99,7 @@ typedef struct SDLTest_TestSuiteReference {
 
 
 /**
- * \brief Generates a random run seed string for the harness. The generated seed will contain alphanumeric characters (0-9A-Z).
+ * Generates a random run seed string for the harness. The generated seed will contain alphanumeric characters (0-9A-Z).
  *
  * Note: The returned string needs to be deallocated by the caller.
  *
@@ -110,7 +110,7 @@ typedef struct SDLTest_TestSuiteReference {
 char *SDLTest_GenerateRunSeed(const int length);
 
 /**
- * \brief Execute a test suite using the given run seed and execution key.
+ * Execute a test suite using the given run seed and execution key.
  *
  * \param testSuites Suites containing the test case.
  * \param userRunSeed Custom run seed provided by user, or NULL to autogenerate one.

include/SDL3/SDL_test_log.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_log.h
  *
- *  \brief Logging related functions of SDL test framework.
+ *  Logging related functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -43,14 +43,14 @@ extern "C" {
 #endif
 
 /**
- * \brief Prints given message with a timestamp in the TEST category and INFO priority.
+ * Prints given message with a timestamp in the TEST category and INFO priority.
  *
  * \param fmt Message to be logged
  */
 void SDLTest_Log(SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(1);
 
 /**
- * \brief Prints given message with a timestamp in the TEST category and the ERROR priority.
+ * Prints given message with a timestamp in the TEST category and the ERROR priority.
  *
  * \param fmt Message to be logged
  */

include/SDL3/SDL_test_md5.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_md5.h
  *
- *  \brief MD5 related functions of SDL test framework.
+ *  MD5 related functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -78,7 +78,7 @@ extern "C" {
 /* ---------- Function Prototypes ------------- */
 
 /**
- * \brief initialize the context
+ * initialize the context
  *
  * \param  mdContext        pointer to context variable
  *
@@ -90,7 +90,7 @@ extern "C" {
 
 
 /**
- * \brief update digest from variable length data
+ * update digest from variable length data
  *
  * \param  mdContext       pointer to context variable
  * \param  inBuf           pointer to data array/string
@@ -106,7 +106,7 @@ extern "C" {
 
 
 /**
- * \brief complete digest computation
+ * complete digest computation
  *
  * \param mdContext     pointer to context variable
  *

include/SDL3/SDL_test_memory.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_memory.h
  *
- *  \brief Memory tracking related functions of SDL test framework.
+ *  Memory tracking related functions of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -38,21 +38,21 @@ extern "C" {
 
 
 /**
- * \brief Start tracking SDL memory allocations
+ * Start tracking SDL memory allocations
  *
  * \note This should be called before any other SDL functions for complete tracking coverage
  */
 void SDLTest_TrackAllocations(void);
 
 /**
- * \brief Fill allocations with random data
+ * Fill allocations with random data
  *
  * \note This implicitly calls SDLTest_TrackAllocations()
  */
 void SDLTest_RandFillAllocations();
 
 /**
- * \brief Print a log of any outstanding allocations
+ * Print a log of any outstanding allocations
  *
  * \note This can be called after SDL_Quit()
  */

include/SDL3/SDL_test_random.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_test_random.h
  *
- *  \brief Random number generator related function of SDL test framework.
+ *  Random number generator related function of SDL test framework.
  *
  *  This code is a part of the SDL test library, not the main SDL library.
  */
@@ -68,7 +68,7 @@ extern "C" {
 /* --- Function prototypes */
 
 /**
- *  \brief Initialize random number generator with two integers.
+ *  Initialize random number generator with two integers.
  *
  *  Note: The random sequence of numbers returned by ...Random() is the
  *  same for the same two integers and has a period of 2^31.
@@ -81,7 +81,7 @@ extern "C" {
  void SDLTest_RandomInit(SDLTest_RandomContext *rndContext, unsigned int xi, unsigned int ci);
 
 /**
- *  \brief Initialize random number generator based on current system time.
+ *  Initialize random number generator based on current system time.
  *
  *  \param rndContext     pointer to context structure
  *
@@ -90,7 +90,7 @@ extern "C" {
 
 
 /**
- *  \brief Initialize random number generator based on current system time.
+ *  Initialize random number generator based on current system time.
  *
  *  Note: ...RandomInit() or ...RandomInitTime() must have been called
  *  before using this function.

include/SDL3/SDL_thread.h

@@ -25,7 +25,7 @@
 /**
  *  \file SDL_thread.h
  *
- *  \brief Header for the SDL thread management routines.
+ *  Header for the SDL thread management routines.
  */
 
 #include <SDL3/SDL_stdinc.h>

include/SDL3/SDL_timer.h

@@ -25,7 +25,7 @@
 /**
  *  \file SDL_timer.h
  *
- *  \brief Header for the SDL time management routines.
+ *  Header for the SDL time management routines.
  */
 
 #include <SDL3/SDL_stdinc.h>

include/SDL3/SDL_touch.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_touch.h
  *
- *  \brief Include file for SDL touch event handling.
+ *  Include file for SDL touch event handling.
  */
 
 #ifndef SDL_touch_h_

include/SDL3/SDL_version.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_version.h
  *
- *  \brief This header defines the current SDL version.
+ *  This header defines the current SDL version.
  */
 
 #ifndef SDL_version_h_

include/SDL3/SDL_video.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_video.h
  *
- *  \brief Header file for SDL video functions.
+ *  Header file for SDL video functions.
  */
 
 #ifndef SDL_video_h_
@@ -45,7 +45,7 @@ typedef Uint32 SDL_DisplayID;
 typedef Uint32 SDL_WindowID;
 
 /**
- *  \brief System theme
+ *  System theme
  */
 typedef enum
 {
@@ -55,7 +55,7 @@ typedef enum
 } SDL_SystemTheme;
 
 /**
- *  \brief  The structure that defines a display mode
+ *  The structure that defines a display mode
  *
  *  \sa SDL_GetFullscreenDisplayModes()
  *  \sa SDL_GetDesktopDisplayMode()
@@ -75,7 +75,7 @@ typedef struct
 } SDL_DisplayMode;
 
 /**
- *  \brief Display orientation
+ *  Display orientation
  */
 typedef enum
 {
@@ -87,7 +87,7 @@ typedef enum
 } SDL_DisplayOrientation;
 
 /**
- *  \brief The type used to identify a window
+ *  The type used to identify a window
  *
  *  \sa SDL_CreateWindow()
  *  \sa SDL_CreateWindowFrom()
@@ -122,7 +122,7 @@ typedef enum
 typedef struct SDL_Window SDL_Window;
 
 /**
- *  \brief The flags on a window
+ *  The flags on a window
  *
  *  \sa SDL_GetWindowFlags()
  */
@@ -155,7 +155,7 @@ typedef enum
 } SDL_WindowFlags;
 
 /**
- *  \brief Used to indicate that you don't care what the window position is.
+ *  Used to indicate that you don't care what the window position is.
  */
 #define SDL_WINDOWPOS_UNDEFINED_MASK    0x1FFF0000u
 #define SDL_WINDOWPOS_UNDEFINED_DISPLAY(X)  (SDL_WINDOWPOS_UNDEFINED_MASK|(X))
@@ -164,7 +164,7 @@ typedef enum
             (((X)&0xFFFF0000) == SDL_WINDOWPOS_UNDEFINED_MASK)
 
 /**
- *  \brief Used to indicate that the window position should be centered.
+ *  Used to indicate that the window position should be centered.
  */
 #define SDL_WINDOWPOS_CENTERED_MASK    0x2FFF0000u
 #define SDL_WINDOWPOS_CENTERED_DISPLAY(X)  (SDL_WINDOWPOS_CENTERED_MASK|(X))
@@ -173,7 +173,7 @@ typedef enum
             (((X)&0xFFFF0000) == SDL_WINDOWPOS_CENTERED_MASK)
 
 /**
- *  \brief Window flash operation
+ *  Window flash operation
  */
 typedef enum
 {
@@ -183,12 +183,12 @@ typedef enum
 } SDL_FlashOperation;
 
 /**
- *  \brief An opaque handle to an OpenGL context.
+ *  An opaque handle to an OpenGL context.
  */
 typedef void *SDL_GLContext;
 
 /**
- *  \brief Opaque EGL types.
+ *  Opaque EGL types.
  */
 typedef void *SDL_EGLDisplay;
 typedef void *SDL_EGLConfig;
@@ -197,13 +197,13 @@ typedef intptr_t SDL_EGLAttrib;
 typedef int SDL_EGLint;
 
 /**
- *  \brief EGL attribute initialization callback types.
+ *  EGL attribute initialization callback types.
  */
 typedef SDL_EGLAttrib *(SDLCALL *SDL_EGLAttribArrayCallback)(void);
 typedef SDL_EGLint *(SDLCALL *SDL_EGLIntArrayCallback)(void);
 
 /**
- *  \brief OpenGL configuration attributes
+ *  OpenGL configuration attributes
  */
 typedef enum
 {

include/SDL3/SDL_vulkan.h

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_vulkan.h
  *
- *  \brief Header file for functions to creating Vulkan surfaces on SDL windows.
+ *  Header file for functions to creating Vulkan surfaces on SDL windows.
  */
 
 #ifndef SDL_vulkan_h_

include/build_config/SDL_build_config.h

@@ -27,7 +27,7 @@
 /**
  *  \file SDL_build_config.h
  *
- *  \brief This is a set of defines to configure the SDL features
+ *  This is a set of defines to configure the SDL features
  */
 
 /* Add any platform that doesn't build using the configure system. */

include/build_config/SDL_build_config.h.cmake

@@ -22,7 +22,7 @@
 /**
  *  \file SDL_build_config.h
  *
- *  \brief This is a set of defines to configure the SDL features
+ *  This is a set of defines to configure the SDL features
  */
 
 #ifndef SDL_build_config_h_

include/build_config/SDL_revision.h.cmake

@@ -22,7 +22,7 @@
 /**
 *  \file SDL_revision.h
 *
-*  \brief Header file containing the SDL revision.
+*  Header file containing the SDL revision.
 */
 
 #ifndef SDL_revision_h_

src/core/linux/SDL_udev.h

@@ -35,7 +35,7 @@
 #include <sys/types.h>
 
 /**
- *  \brief Device type
+ *  Device type
  */
 
 typedef enum

src/hidapi/doxygen/Doxyfile

@@ -214,7 +214,7 @@ JAVADOC_BANNER         = NO
 # If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
 # line (until the first dot) of a Qt-style comment as the brief description. If
 # set to NO, the Qt-style will behave just like regular Qt-style comments (thus
-# requiring an explicit \brief command for a brief description.)
+# requiring an explicit command for a brief description.)
 # The default value is: NO.
 
 QT_AUTOBRIEF           = NO

src/render/software/SDL_rotate.c

@@ -44,7 +44,7 @@ Andreas Schiffler -- aschiffler at ferzkopp dot net
 /* ---- Internally used structures */
 
 /**
-\brief A 32 bit RGBA pixel.
+A 32 bit RGBA pixel.
 */
 typedef struct tColorRGBA
 {
@@ -55,7 +55,7 @@ typedef struct tColorRGBA
 } tColorRGBA;
 
 /**
-\brief A 8bit Y/palette pixel.
+A 8bit Y/palette pixel.
 */
 typedef struct tColorY
 {
@@ -63,7 +63,7 @@ typedef struct tColorY
 } tColorY;
 
 /**
-\brief Number of guard rows added to destination surfaces.
+Number of guard rows added to destination surfaces.
 
 This is a simple but effective workaround for observed issues.
 These rows allocate extra memory and are then hidden from the surface.
@@ -75,7 +75,7 @@ to a situation where the program can segfault.
 #define GUARD_ROWS (2)
 
 /**
-\brief Returns colorkey info for a surface
+Returns colorkey info for a surface
 */
 static Uint32 get_colorkey(SDL_Surface *src)
 {
@@ -100,7 +100,7 @@ static void rotate(double sx, double sy, double sinangle, double cosangle, const
 }
 
 /**
-\brief Internal target surface sizing function for rotations with trig result return.
+Internal target surface sizing function for rotations with trig result return.
 
 \param width The source surface width.
 \param height The source surface height.
@@ -249,7 +249,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.
+Internal 32 bit rotozoomer with optional anti-aliasing.
 
 Rotates and zooms 32 bit RGBA/ABGR 'src' surface to 'dst' surface based on the control
 parameters by scanning the destination surface and applying optionally anti-aliasing
@@ -391,7 +391,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.
+Rotates and zooms 8 bit palette/Y 'src' surface to 'dst' surface without smoothing.
 
 Rotates and zooms 8 bit RGBA/ABGR 'src' surface to 'dst' surface based on the control
 parameters by scanning the destination surface.
@@ -462,7 +462,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 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.
 'angle' is the rotation in degrees, 'center' the rotation center. If 'smooth' is set

src/test/SDL_test_assert.c

@@ -48,10 +48,10 @@
 #define SDLTEST_ASSERT_SUMMARY_FORMAT    "Assert Summary: Total=%d " COLOR_GREEN "Passed=%d" COLOR_END " " COLOR_RED "Failed=%d" COLOR_END
 #define SDLTEST_ASSERT_SUMMARY_FORMAT_OK "Assert Summary: Total=%d " COLOR_GREEN "Passed=%d" COLOR_END " " COLOR_GREEN "Failed=%d" COLOR_END
 
-/* ! \brief counts the failed asserts */
+/* ! counts the failed asserts */
 static int SDLTest_AssertsFailed = 0;
 
-/* ! \brief counts the passed asserts */
+/* ! counts the passed asserts */
 static int SDLTest_AssertsPassed = 0;
 
 /*

src/test/SDL_test_font.c

@@ -3122,7 +3122,7 @@ struct SDLTest_CharTextureCache
 };
 
 /*!
-\brief List of per-renderer caches for 8x8 pixel font textures created at runtime.
+List of per-renderer caches for 8x8 pixel font textures created at runtime.
 */
 static struct SDLTest_CharTextureCache *SDLTest_CharTextureCacheList;
 

src/test/SDL_test_harness.c

@@ -47,7 +47,7 @@
 /* Final result message format */
 #define SDLTEST_FINAL_RESULT_FORMAT COLOR_YELLOW ">>> %s '%s':" COLOR_END " %s\n"
 
-/* ! \brief Timeout for single test case execution */
+/* ! Timeout for single test case execution */
 static Uint32 SDLTest_TestCaseTimeout = 3600;
 
 /**
@@ -167,7 +167,7 @@ static Uint64 SDLTest_GenerateExecKey(const char *runSeed, const char *suiteName
 }
 
 /**
- * \brief Set timeout handler for test.
+ * Set timeout handler for test.
  *
  * Note: SDL_Init(SDL_INIT_TIMER) will be called if it wasn't done so before.
  *
@@ -211,7 +211,7 @@ static SDL_TimerID SDLTest_SetTestTimeout(int timeout, void(SDLCALL *callback)(v
 }
 
 /**
- * \brief Timeout handler. Aborts test run and exits harness process.
+ * Timeout handler. Aborts test run and exits harness process.
  */
 #ifdef __WATCOMC__
 #pragma aux SDLTest_BailOut aborts;
@@ -223,7 +223,7 @@ static SDL_NORETURN void SDLCALL SDLTest_BailOut(void)
 }
 
 /**
- * \brief Execute a test using the given execution key.
+ * Execute a test using the given execution key.
  *
  * \param testSuite Suite containing the test case.
  * \param testCase Case to execute.
@@ -356,7 +356,7 @@ static float GetClock(void)
 }
 
 /**
- * \brief Execute a test suite using the given run seed and execution key.
+ * Execute a test suite using the given run seed and execution key.
  *
  * The filter string is matched to the suite name (full comparison) to select a single suite,
  * or if no suite matches, it is matched to the test names (full comparison) to select a single test.

test/testautomation_audio.c

@@ -59,7 +59,7 @@ static SDL_AudioDeviceID g_audio_id = -1;
 /* Test case functions */
 
 /**
- * \brief Stop and restart audio subsystem
+ * Stop and restart audio subsystem
  *
  * \sa SDL_QuitSubSystem
  * \sa SDL_InitSubSystem
@@ -77,7 +77,7 @@ static int audio_quitInitAudioSubSystem(void *arg)
 }
 
 /**
- * \brief Start and stop audio directly
+ * Start and stop audio directly
  *
  * \sa SDL_InitAudio
  * \sa SDL_QuitAudio
@@ -133,7 +133,7 @@ static int audio_initQuitAudio(void *arg)
 }
 
 /**
- * \brief Start, open, close and stop audio
+ * Start, open, close and stop audio
  *
  * \sa SDL_InitAudio
  * \sa SDL_OpenAudioDevice
@@ -219,7 +219,7 @@ static int audio_initOpenCloseQuitAudio(void *arg)
 }
 
 /**
- * \brief Pause and unpause audio
+ * Pause and unpause audio
  *
  * \sa SDL_PauseAudioDevice
  * \sa SDL_PlayAudioDevice
@@ -340,7 +340,7 @@ static int audio_pauseUnpauseAudio(void *arg)
 }
 
 /**
- * \brief Enumerate and name available audio devices (output and capture).
+ * Enumerate and name available audio devices (output and capture).
  *
  * \sa SDL_GetNumAudioDevices
  * \sa SDL_GetAudioDeviceName
@@ -381,7 +381,7 @@ static int audio_enumerateAndNameAudioDevices(void *arg)
 }
 
 /**
- * \brief Negative tests around enumeration and naming of audio devices.
+ * Negative tests around enumeration and naming of audio devices.
  *
  * \sa SDL_GetNumAudioDevices
  * \sa SDL_GetAudioDeviceName
@@ -392,7 +392,7 @@ static int audio_enumerateAndNameAudioDevicesNegativeTests(void *arg)
 }
 
 /**
- * \brief Checks available audio driver names.
+ * Checks available audio driver names.
  *
  * \sa SDL_GetNumAudioDrivers
  * \sa SDL_GetAudioDriver
@@ -423,7 +423,7 @@ static int audio_printAudioDrivers(void *arg)
 }
 
 /**
- * \brief Checks current audio driver name with initialized audio.
+ * Checks current audio driver name with initialized audio.
  *
  * \sa SDL_GetCurrentAudioDriver
  */
@@ -470,7 +470,7 @@ SDL_COMPILE_TIME_ASSERT(SDL_AUDIO_F32LE_FORMAT, SDL_AUDIO_F32LE == (SDL_AUDIO_BI
 SDL_COMPILE_TIME_ASSERT(SDL_AUDIO_F32BE_FORMAT, SDL_AUDIO_F32BE == (SDL_AUDIO_F32LE | SDL_AUDIO_MASK_BIG_ENDIAN));
 
 /**
- * \brief Builds various audio conversion structures
+ * Builds various audio conversion structures
  *
  * \sa SDL_CreateAudioStream
  */
@@ -539,7 +539,7 @@ static int audio_buildAudioStream(void *arg)
 }
 
 /**
- * \brief Checks calls with invalid input to SDL_CreateAudioStream
+ * Checks calls with invalid input to SDL_CreateAudioStream
  *
  * \sa SDL_CreateAudioStream
  */
@@ -619,7 +619,7 @@ static int audio_buildAudioStreamNegative(void *arg)
 }
 
 /**
- * \brief Checks current audio status.
+ * Checks current audio status.
  *
  * \sa SDL_GetAudioDeviceStatus
  */
@@ -629,7 +629,7 @@ static int audio_getAudioStatus(void *arg)
 }
 
 /**
- * \brief Opens, checks current audio status, and closes a device.
+ * Opens, checks current audio status, and closes a device.
  *
  * \sa SDL_GetAudioStatus
  */
@@ -639,7 +639,7 @@ static int audio_openCloseAndGetAudioStatus(void *arg)
 }
 
 /**
- * \brief Locks and unlocks open audio device.
+ * Locks and unlocks open audio device.
  *
  * \sa SDL_LockAudioDevice
  * \sa SDL_UnlockAudioDevice
@@ -650,7 +650,7 @@ static int audio_lockUnlockOpenAudioDevice(void *arg)
 }
 
 /**
- * \brief Convert audio using various conversion structures
+ * Convert audio using various conversion structures
  *
  * \sa SDL_CreateAudioStream
  */
@@ -784,7 +784,7 @@ static int audio_convertAudio(void *arg)
 }
 
 /**
- * \brief Opens, checks current connected status, and closes a device.
+ * Opens, checks current connected status, and closes a device.
  *
  * \sa SDL_AudioDeviceConnected
  */
@@ -806,7 +806,7 @@ static double sine_wave_sample(const Sint64 idx, const Sint64 rate, const Sint64
 }
 
 /**
- * \brief Check signal-to-noise ratio and maximum error of audio resampling.
+ * Check signal-to-noise ratio and maximum error of audio resampling.
  *
  * \sa https://wiki.libsdl.org/SDL_CreateAudioStream
  * \sa https://wiki.libsdl.org/SDL_DestroyAudioStream
@@ -963,7 +963,7 @@ static int audio_resampleLoss(void *arg)
 }
 
 /**
- * \brief Check accuracy converting between audio formats.
+ * Check accuracy converting between audio formats.
  *
  * \sa SDL_ConvertAudioSamples
  */
@@ -1098,7 +1098,7 @@ static int audio_convertAccuracy(void *arg)
 }
 
 /**
- * \brief Check accuracy when switching between formats
+ * Check accuracy when switching between formats
  *
  * \sa SDL_SetAudioStreamFormat
  */

test/testautomation_clipboard.c

@@ -74,7 +74,7 @@ static void ClipboardCleanupCallback(void *userdata)
 /* Test case functions */
 
 /**
- * \brief End-to-end test of SDL_xyzClipboardData functions
+ * End-to-end test of SDL_xyzClipboardData functions
  * \sa SDL_HasClipboardData
  * \sa SDL_GetClipboardData
  * \sa SDL_SetClipboardData
@@ -373,7 +373,7 @@ static int clipboard_testClipboardDataFunctions(void *arg)
 }
 
 /**
- * \brief End-to-end test of SDL_xyzClipboardText functions
+ * End-to-end test of SDL_xyzClipboardText functions
  * \sa SDL_HasClipboardText
  * \sa SDL_GetClipboardText
  * \sa SDL_SetClipboardText
@@ -457,7 +457,7 @@ static int clipboard_testClipboardTextFunctions(void *arg)
 }
 
 /**
- * \brief End-to-end test of SDL_xyzPrimarySelectionText functions
+ * End-to-end test of SDL_xyzPrimarySelectionText functions
  * \sa SDL_HasPrimarySelectionText
  * \sa SDL_GetPrimarySelectionText
  * \sa SDL_SetPrimarySelectionText

test/testautomation_events.c

@@ -38,7 +38,7 @@ static int SDLCALL events_sampleNullEventFilter(void *userdata, SDL_Event *event
 }
 
 /**
- * \brief Test pumping and peeking events.
+ * Test pumping and peeking events.
  *
  * \sa SDL_PumpEvents
  * \sa SDL_PollEvent
@@ -75,7 +75,7 @@ static int events_pushPumpAndPollUserevent(void *arg)
 }
 
 /**
- * \brief Adds and deletes an event watch function with NULL userdata
+ * Adds and deletes an event watch function with NULL userdata
  *
  * \sa SDL_AddEventWatch
  * \sa SDL_DelEventWatch
@@ -125,7 +125,7 @@ static int events_addDelEventWatch(void *arg)
 }
 
 /**
- * \brief Adds and deletes an event watch function with userdata
+ * Adds and deletes an event watch function with userdata
  *
  * \sa SDL_AddEventWatch
  * \sa SDL_DelEventWatch

test/testautomation_guid.c

@@ -70,7 +70,7 @@ upper_lower_to_bytestring(Uint8 *out, Uint64 upper, Uint64 lower)
 /* Test case functions */
 
 /**
- * \brief Check String-to-GUID conversion
+ * Check String-to-GUID conversion
  *
  * \sa SDL_GUIDFromString
  */
@@ -95,7 +95,7 @@ TestGuidFromString(void *arg)
 }
 
 /**
- * \brief Check GUID-to-String conversion
+ * Check GUID-to-String conversion
  *
  * \sa SDL_GUIDToString
  */

test/testautomation_hints.c

@@ -60,7 +60,7 @@ static const int numHintsEnum = SDL_arraysize(HintsEnum);
 /* Test case functions */
 
 /**
- * \brief Call to SDL_GetHint
+ * Call to SDL_GetHint
  */
 static int hints_getHint(void *arg)
 {
@@ -89,7 +89,7 @@ static void SDLCALL hints_testHintChanged(void *userdata, const char *name, cons
 }
 
 /**
- * \brief Call to SDL_SetHint
+ * Call to SDL_SetHint
  */
 static int hints_setHint(void *arg)
 {

test/testautomation_images.c

@@ -528,7 +528,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlit = {
 };
 
 /**
- * \brief Returns the Blit test image as SDL_Surface.
+ * Returns the Blit test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlit(void)
 {
@@ -1000,7 +1000,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitColor = {
 };
 
 /**
- * \brief Returns the BlitColor test image as SDL_Surface.
+ * Returns the BlitColor test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitColor(void)
 {
@@ -1635,7 +1635,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitAlpha = {
 };
 
 /**
- * \brief Returns the BlitAlpha test image as SDL_Surface.
+ * Returns the BlitAlpha test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitAlpha(void)
 {
@@ -2203,7 +2203,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitBlendAdd = {
 };
 
 /**
- * \brief Returns the BlitBlendAdd test image as SDL_Surface.
+ * Returns the BlitBlendAdd test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitBlendAdd(void)
 {
@@ -2792,7 +2792,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitBlend = {
 };
 
 /**
- * \brief Returns the BlitBlend test image as SDL_Surface.
+ * Returns the BlitBlend test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitBlend(void)
 {
@@ -3211,7 +3211,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitBlendMod = {
 };
 
 /**
- * \brief Returns the BlitBlendMod test image as SDL_Surface.
+ * Returns the BlitBlendMod test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitBlendMod(void)
 {
@@ -4013,7 +4013,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitBlendNone = {
 };
 
 /**
- * \brief Returns the BlitBlendNone test image as SDL_Surface.
+ * Returns the BlitBlendNone test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitBlendNone(void)
 {
@@ -4547,7 +4547,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageBlitBlendAll = {
 };
 
 /**
- * \brief Returns the BlitBlendAll test image as SDL_Surface.
+ * Returns the BlitBlendAll test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageBlitBlendAll(void)
 {
@@ -4758,7 +4758,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imageFace = {
 };
 
 /**
- * \brief Returns the Face test image as SDL_Surface.
+ * Returns the Face test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImageFace(void)
 {
@@ -5251,7 +5251,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imagePrimitives = {
 };
 
 /**
- * \brief Returns the Primitives test image as SDL_Surface.
+ * Returns the Primitives test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImagePrimitives(void)
 {
@@ -5916,7 +5916,7 @@ static const SDLTest_SurfaceImage_t SDLTest_imagePrimitivesBlend = {
 };
 
 /**
- * \brief Returns the PrimitivesBlend test image as SDL_Surface.
+ * Returns the PrimitivesBlend test image as SDL_Surface.
  */
 SDL_Surface *SDLTest_ImagePrimitivesBlend(void)
 {

test/testautomation_intrinsics.c

@@ -86,7 +86,7 @@ static void free_arrays(void *dest, void *a, void *b) {
 }
 
 /**
- * \brief Verify element-wise addition of 2 int arrays.
+ * Verify element-wise addition of 2 int arrays.
  */
 static void verify_ints_addition(const Sint32 *dest, const Sint32 *a, const Sint32 *b, size_t size, const char *desc) {
     size_t i;
@@ -106,7 +106,7 @@ static void verify_ints_addition(const Sint32 *dest, const Sint32 *a, const Sint
 }
 
 /**
- * \brief Verify element-wise multiplication of 2 int arrays.
+ * Verify element-wise multiplication of 2 int arrays.
  */
 static void verify_ints_multiplication(const Sint32 *dest, const Sint32 *a, const Sint32 *b, size_t size, const char *desc) {
     size_t i;
@@ -126,7 +126,7 @@ static void verify_ints_multiplication(const Sint32 *dest, const Sint32 *a, cons
 }
 
 /**
- * \brief Verify element-wise addition of 2 float arrays.
+ * Verify element-wise addition of 2 float arrays.
  */
 static void verify_floats_addition(const float *dest, const float *a, const float *b, size_t size, const char *desc) {
     size_t i;
@@ -147,7 +147,7 @@ static void verify_floats_addition(const float *dest, const float *a, const floa
 }
 
 /**
- * \brief Verify element-wise addition of 2 double arrays.
+ * Verify element-wise addition of 2 double arrays.
  */
 static void verify_doubles_addition(const double *dest, const double *a, const double *b, size_t size, const char *desc) {
     size_t i;

test/testautomation_joystick.c

@@ -12,7 +12,7 @@
 /* Test case functions */
 
 /**
- * \brief Check virtual joystick creation
+ * Check virtual joystick creation
  *
  * \sa SDL_AttachVirtualJoystickEx
  */

test/testautomation_keyboard.c

@@ -11,7 +11,7 @@
 /* Test case functions */
 
 /**
- * \brief Check call to SDL_GetKeyboardState with and without numkeys reference.
+ * Check call to SDL_GetKeyboardState with and without numkeys reference.
  *
  * \sa SDL_GetKeyboardState
  */
@@ -36,7 +36,7 @@ static int keyboard_getKeyboardState(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetKeyboardFocus
+ * Check call to SDL_GetKeyboardFocus
  *
  * \sa SDL_GetKeyboardFocus
  */
@@ -50,7 +50,7 @@ static int keyboard_getKeyboardFocus(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetKeyFromName for known, unknown and invalid name.
+ * Check call to SDL_GetKeyFromName for known, unknown and invalid name.
  *
  * \sa SDL_GetKeyFromName
  */
@@ -115,7 +115,7 @@ static void checkInvalidScancodeError(void)
 }
 
 /**
- * \brief Check call to SDL_GetKeyFromScancode
+ * Check call to SDL_GetKeyFromScancode
  *
  * \sa SDL_GetKeyFromScancode
  */
@@ -153,7 +153,7 @@ static int keyboard_getKeyFromScancode(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetKeyName
+ * Check call to SDL_GetKeyName
  *
  * \sa SDL_GetKeyName
  */
@@ -208,7 +208,7 @@ static int keyboard_getKeyName(void *arg)
 }
 
 /**
- * \brief SDL_GetScancodeName negative cases
+ * SDL_GetScancodeName negative cases
  *
  * \sa SDL_GetScancodeName
  */
@@ -234,7 +234,7 @@ static int keyboard_getScancodeNameNegative(void *arg)
 }
 
 /**
- * \brief SDL_GetKeyName negative cases
+ * SDL_GetKeyName negative cases
  *
  * \sa SDL_GetKeyName
  */
@@ -270,7 +270,7 @@ static int keyboard_getKeyNameNegative(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetModState and SDL_SetModState
+ * Check call to SDL_GetModState and SDL_SetModState
  *
  * \sa SDL_GetModState
  * \sa SDL_SetModState
@@ -329,7 +329,7 @@ static int keyboard_getSetModState(void *arg)
 }
 
 /**
- * \brief Check call to SDL_StartTextInput and SDL_StopTextInput
+ * Check call to SDL_StartTextInput and SDL_StopTextInput
  *
  * \sa SDL_StartTextInput
  * \sa SDL_StopTextInput
@@ -375,7 +375,7 @@ static void testSetTextInputRect(SDL_Rect refRect)
 }
 
 /**
- * \brief Check call to SDL_SetTextInputRect
+ * Check call to SDL_SetTextInputRect
  *
  * \sa SDL_SetTextInputRect
  */
@@ -454,7 +454,7 @@ static int keyboard_setTextInputRect(void *arg)
 }
 
 /**
- * \brief Check call to SDL_SetTextInputRect with invalid data
+ * Check call to SDL_SetTextInputRect with invalid data
  *
  * \sa SDL_SetTextInputRect
  */
@@ -491,7 +491,7 @@ static int keyboard_setTextInputRectNegative(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetScancodeFromKey
+ * Check call to SDL_GetScancodeFromKey
  *
  * \sa SDL_GetScancodeFromKey
  * \sa SDL_Keycode
@@ -514,7 +514,7 @@ static int keyboard_getScancodeFromKey(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetScancodeFromName
+ * Check call to SDL_GetScancodeFromName
  *
  * \sa SDL_GetScancodeFromName
  * \sa SDL_Keycode
@@ -585,7 +585,7 @@ static void checkInvalidNameError(void)
 }
 
 /**
- * \brief Check call to SDL_GetScancodeFromName with invalid data
+ * Check call to SDL_GetScancodeFromName with invalid data
  *
  * \sa SDL_GetScancodeFromName
  * \sa SDL_Keycode

test/testautomation_main.c

@@ -11,7 +11,7 @@
 #include "testautomation_suites.h"
 
 /**
- * \brief Tests SDL_InitSubSystem() and SDL_QuitSubSystem()
+ * Tests SDL_InitSubSystem() and SDL_QuitSubSystem()
  * \sa SDL_Init
  * \sa SDL_Quit
  */

test/testautomation_math.c

@@ -62,7 +62,7 @@ typedef double(SDLCALL *d_to_d_func)(double);
 typedef double(SDLCALL *dd_to_d_func)(double, double);
 
 /**
- * \brief Runs all the cases on a given function with a signature double -> double.
+ * Runs all the cases on a given function with a signature double -> double.
  * The result is expected to be exact.
  *
  * \param func_name a printable name for the tested function.
@@ -88,7 +88,7 @@ helper_dtod(const char *func_name, d_to_d_func func,
 }
 
 /**
- * \brief Runs all the cases on a given function with a signature double -> double.
+ * Runs all the cases on a given function with a signature double -> double.
  * Checks if the result between expected +/- EPSILON.
  *
  * \param func_name a printable name for the tested function.
@@ -117,7 +117,7 @@ helper_dtod_inexact(const char *func_name, d_to_d_func func,
 }
 
 /**
- * \brief Runs all the cases on a given function with a signature
+ * Runs all the cases on a given function with a signature
  * (double, double) -> double. The result is expected to be exact.
  *
  * \param func_name a printable name for the tested function.
@@ -143,7 +143,7 @@ helper_ddtod(const char *func_name, dd_to_d_func func,
 }
 
 /**
- * \brief Runs all the cases on a given function with a signature
+ * Runs all the cases on a given function with a signature
  * (double, double) -> double. Checks if the result between expected +/- EPSILON.
  *
  * \param func_name a printable name for the tested function.
@@ -172,7 +172,7 @@ helper_ddtod_inexact(const char *func_name, dd_to_d_func func,
 }
 
 /**
- * \brief Runs a range of values on a given function with a signature double -> double
+ * Runs a range of values on a given function with a signature double -> double
  *
  * This function is only meant to test functions that returns the input value if it is
  * integral: f(x) -> x for x in N.

test/testautomation_mouse.c

@@ -25,7 +25,7 @@ static int mouseStateCheck(Uint32 state)
 }
 
 /**
- * \brief Check call to SDL_GetMouseState
+ * Check call to SDL_GetMouseState
  *
  */
 static int mouse_getMouseState(void *arg)
@@ -70,7 +70,7 @@ static int mouse_getMouseState(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetRelativeMouseState
+ * Check call to SDL_GetRelativeMouseState
  *
  */
 static int mouse_getRelativeMouseState(void *arg)
@@ -188,7 +188,7 @@ static SDL_Cursor *initArrowCursor(const char *image[])
 }
 
 /**
- * \brief Check call to SDL_CreateCursor and SDL_DestroyCursor
+ * Check call to SDL_CreateCursor and SDL_DestroyCursor
  *
  * \sa SDL_CreateCursor
  * \sa SDL_DestroyCursor
@@ -213,7 +213,7 @@ static int mouse_createFreeCursor(void *arg)
 }
 
 /**
- * \brief Check call to SDL_CreateColorCursor and SDL_DestroyCursor
+ * Check call to SDL_CreateColorCursor and SDL_DestroyCursor
  *
  * \sa SDL_CreateColorCursor
  * \sa SDL_DestroyCursor
@@ -269,7 +269,7 @@ static void changeCursorVisibility(SDL_bool state)
 }
 
 /**
- * \brief Check call to SDL_ShowCursor
+ * Check call to SDL_ShowCursor
  *
  * \sa SDL_ShowCursor
  */
@@ -294,7 +294,7 @@ static int mouse_showCursor(void *arg)
 }
 
 /**
- * \brief Check call to SDL_SetCursor
+ * Check call to SDL_SetCursor
  *
  * \sa SDL_SetCursor
  */
@@ -326,7 +326,7 @@ static int mouse_setCursor(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetCursor
+ * Check call to SDL_GetCursor
  *
  * \sa SDL_GetCursor
  */
@@ -343,7 +343,7 @@ static int mouse_getCursor(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetRelativeMouseMode and SDL_SetRelativeMouseMode
+ * Check call to SDL_GetRelativeMouseMode and SDL_SetRelativeMouseMode
  *
  * \sa SDL_GetRelativeMouseMode
  * \sa SDL_SetRelativeMouseMode
@@ -426,7 +426,7 @@ static void destroyMouseSuiteTestWindow(SDL_Window *window)
 }
 
 /**
- * \brief Check call to SDL_WarpMouseInWindow
+ * Check call to SDL_WarpMouseInWindow
  *
  * \sa SDL_WarpMouseInWindow
  */
@@ -489,7 +489,7 @@ static int mouse_warpMouseInWindow(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetMouseFocus
+ * Check call to SDL_GetMouseFocus
  *
  * \sa SDL_GetMouseFocus
  */
@@ -555,7 +555,7 @@ static int mouse_getMouseFocus(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetDefaultCursor
+ * Check call to SDL_GetDefaultCursor
  *
  * \sa SDL_GetDefaultCursor
  */
@@ -572,7 +572,7 @@ static int mouse_getDefaultCursor(void *arg)
 }
 
 /**
- * \brief Check call to SDL_GetGlobalMouseState
+ * Check call to SDL_GetGlobalMouseState
  *
  * \sa SDL_GetGlobalMouseState
  */

test/testautomation_pixels.c

@@ -111,7 +111,7 @@ static const char *g_invalidPixelFormatsVerbose[] = {
 /* Test case functions */
 
 /**
- * \brief Call to SDL_CreatePixelFormat and SDL_DestroyPixelFormat
+ * Call to SDL_CreatePixelFormat and SDL_DestroyPixelFormat
  *
  * \sa SDL_CreatePixelFormat
  * \sa SDL_DestroyPixelFormat
@@ -204,7 +204,7 @@ static int pixels_allocFreeFormat(void *arg)
 }
 
 /**
- * \brief Call to SDL_GetPixelFormatName
+ * Call to SDL_GetPixelFormatName
  *
  * \sa SDL_GetPixelFormatName
  */
@@ -271,7 +271,7 @@ static int pixels_getPixelFormatName(void *arg)
 }
 
 /**
- * \brief Call to SDL_CreatePalette and SDL_DestroyPalette
+ * Call to SDL_CreatePalette and SDL_DestroyPalette
  *
  * \sa SDL_CreatePalette
  * \sa SDL_DestroyPalette

test/testautomation_platform.c

@@ -11,7 +11,7 @@
 /* Helper functions */
 
 /**
- * \brief Compare sizes of types.
+ * 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
@@ -25,7 +25,7 @@ static int compareSizeOfType(size_t sizeoftype, size_t hardcodetype)
 /* Test case functions */
 
 /**
- * \brief Tests type sizes.
+ * Tests type sizes.
  */
 static int platform_testTypes(void *arg)
 {
@@ -47,7 +47,7 @@ static int platform_testTypes(void *arg)
 }
 
 /**
- * \brief Tests platform endianness and SDL_SwapXY functions.
+ * Tests platform endianness and SDL_SwapXY functions.
  */
 static int platform_testEndianessAndSwap(void *arg)
 {
@@ -118,7 +118,7 @@ static int platform_testEndianessAndSwap(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetXYZ() functions
+ * Tests SDL_GetXYZ() functions
  * \sa SDL_GetPlatform
  * \sa SDL_GetCPUCount
  * \sa SDL_GetRevision
@@ -162,7 +162,7 @@ static int platform_testGetFunctions(void *arg)
 }
 
 /**
- * \brief Tests SDL_HasXYZ() functions
+ * Tests SDL_HasXYZ() functions
  * \sa SDL_HasAltiVec
  * \sa SDL_HasMMX
  * \sa SDL_HasSSE
@@ -204,7 +204,7 @@ static int platform_testHasFunctions(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetVersion
+ * Tests SDL_GetVersion
  * \sa SDL_GetVersion
  */
 static int platform_testGetVersion(void *arg)
@@ -227,7 +227,7 @@ static int platform_testGetVersion(void *arg)
 }
 
 /**
- * \brief Tests SDL_VERSION macro
+ * Tests SDL_VERSION macro
  */
 static int platform_testSDLVersion(void *arg)
 {
@@ -249,7 +249,7 @@ static int platform_testSDLVersion(void *arg)
 }
 
 /**
- * \brief Tests default SDL_Init
+ * Tests default SDL_Init
  */
 static int platform_testDefaultInit(void *arg)
 {
@@ -271,7 +271,7 @@ static int platform_testDefaultInit(void *arg)
 }
 
 /**
- * \brief Tests SDL_Get/Set/ClearError
+ * Tests SDL_Get/Set/ClearError
  * \sa SDL_GetError
  * \sa SDL_SetError
  * \sa SDL_ClearError
@@ -322,7 +322,7 @@ static int platform_testGetSetClearError(void *arg)
 }
 
 /**
- * \brief Tests SDL_SetError with empty input
+ * Tests SDL_SetError with empty input
  * \sa SDL_SetError
  */
 static int platform_testSetErrorEmptyInput(void *arg)
@@ -363,7 +363,7 @@ static int platform_testSetErrorEmptyInput(void *arg)
 #endif
 
 /**
- * \brief Tests SDL_SetError with invalid input
+ * Tests SDL_SetError with invalid input
  * \sa SDL_SetError
  */
 static int platform_testSetErrorInvalidInput(void *arg)
@@ -446,7 +446,7 @@ static int platform_testSetErrorInvalidInput(void *arg)
 #endif
 
 /**
- * \brief Tests SDL_GetPowerInfo
+ * Tests SDL_GetPowerInfo
  * \sa SDL_GetPowerInfo
  */
 static int platform_testGetPowerInfo(void *arg)

test/testautomation_properties.c

@@ -9,7 +9,7 @@
 /* Test case functions */
 
 /**
- * \brief Test basic functionality
+ * Test basic functionality
  */
 static int properties_testBasic(void *arg)
 {
@@ -54,7 +54,7 @@ static int properties_testBasic(void *arg)
 }
 
 /**
- * \brief Test cleanup functionality
+ * Test cleanup functionality
  */
 static void SDLCALL cleanup(void *userdata, void *value)
 {
@@ -91,7 +91,7 @@ static int properties_testCleanup(void *arg)
 }
 
 /**
- * \brief Test locking functionality
+ * Test locking functionality
  */
 struct properties_thread_data
 {

test/testautomation_rect.c

@@ -11,7 +11,7 @@
 /* Helper functions */
 
 /**
- * \brief Private helper to check SDL_GetRectAndLineIntersection results
+ * Private helper to check SDL_GetRectAndLineIntersection results
  */
 static void validateIntersectRectAndLineResults(
     SDL_bool intersection, SDL_bool expectedIntersection,
@@ -38,7 +38,7 @@ static void validateIntersectRectAndLineResults(
 /* Test case functions */
 
 /**
- * \brief Tests SDL_GetRectAndLineIntersection() clipping cases
+ * Tests SDL_GetRectAndLineIntersection() clipping cases
  *
  * \sa SDL_GetRectAndLineIntersection
  */
@@ -107,7 +107,7 @@ static int rect_testIntersectRectAndLine(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectAndLineIntersection() non-clipping case line inside
+ * Tests SDL_GetRectAndLineIntersection() non-clipping case line inside
  *
  * \sa SDL_GetRectAndLineIntersection
  */
@@ -172,7 +172,7 @@ static int rect_testIntersectRectAndLineInside(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectAndLineIntersection() non-clipping cases outside
+ * Tests SDL_GetRectAndLineIntersection() non-clipping cases outside
  *
  * \sa SDL_GetRectAndLineIntersection
  */
@@ -225,7 +225,7 @@ static int rect_testIntersectRectAndLineOutside(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectAndLineIntersection() with empty rectangle
+ * Tests SDL_GetRectAndLineIntersection() with empty rectangle
  *
  * \sa SDL_GetRectAndLineIntersection
  */
@@ -258,7 +258,7 @@ static int rect_testIntersectRectAndLineEmpty(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_GetRectAndLineIntersection() with invalid parameters
+ * Negative tests against SDL_GetRectAndLineIntersection() with invalid parameters
  *
  * \sa SDL_GetRectAndLineIntersection
  */
@@ -291,7 +291,7 @@ static int rect_testIntersectRectAndLineParam(void *arg)
 }
 
 /**
- * \brief Private helper to check SDL_HasRectIntersection results
+ * Private helper to check SDL_HasRectIntersection results
  */
 static void validateHasIntersectionResults(
     SDL_bool intersection, SDL_bool expectedIntersection,
@@ -314,7 +314,7 @@ static void validateHasIntersectionResults(
 }
 
 /**
- * \brief Private helper to check SDL_GetRectIntersection results
+ * Private helper to check SDL_GetRectIntersection results
  */
 static void validateIntersectRectResults(
     SDL_bool intersection, SDL_bool expectedIntersection,
@@ -333,7 +333,7 @@ static void validateIntersectRectResults(
 }
 
 /**
- * \brief Private helper to check SDL_GetRectUnion results
+ * Private helper to check SDL_GetRectUnion results
  */
 static void validateUnionRectResults(
     SDL_Rect *rectA, SDL_Rect *rectB, SDL_Rect *refRectA, SDL_Rect *refRectB,
@@ -356,7 +356,7 @@ static void validateUnionRectResults(
 }
 
 /**
- * \brief Private helper to check SDL_RectEmpty results
+ * Private helper to check SDL_RectEmpty results
  */
 static void validateRectEmptyResults(
     SDL_bool empty, SDL_bool expectedEmpty,
@@ -374,7 +374,7 @@ static void validateRectEmptyResults(
 }
 
 /**
- * \brief Private helper to check SDL_RectsEqual results
+ * Private helper to check SDL_RectsEqual results
  */
 static void validateRectEqualsResults(
     SDL_bool equals, SDL_bool expectedEquals,
@@ -397,7 +397,7 @@ static void validateRectEqualsResults(
 }
 
 /**
- * \brief Private helper to check SDL_RectsEqualFloat results
+ * Private helper to check SDL_RectsEqualFloat results
  */
 static void validateFRectEqualsResults(
     SDL_bool equals, SDL_bool expectedEquals,
@@ -423,7 +423,7 @@ static void validateFRectEqualsResults(
 }
 
 /**
- * \brief Tests SDL_GetRectIntersection() with B fully inside A
+ * Tests SDL_GetRectIntersection() with B fully inside A
  *
  * \sa SDL_GetRectIntersection
  */
@@ -450,7 +450,7 @@ static int rect_testIntersectRectInside(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectIntersection() with B fully outside A
+ * Tests SDL_GetRectIntersection() with B fully outside A
  *
  * \sa SDL_GetRectIntersection
  */
@@ -477,7 +477,7 @@ static int rect_testIntersectRectOutside(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectIntersection() with B partially intersecting A
+ * Tests SDL_GetRectIntersection() with B partially intersecting A
  *
  * \sa SDL_GetRectIntersection
  */
@@ -565,7 +565,7 @@ static int rect_testIntersectRectPartial(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectIntersection() with 1x1 pixel sized rectangles
+ * Tests SDL_GetRectIntersection() with 1x1 pixel sized rectangles
  *
  * \sa SDL_GetRectIntersection
  */
@@ -611,7 +611,7 @@ static int rect_testIntersectRectPoint(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectIntersection() with empty rectangles
+ * Tests SDL_GetRectIntersection() with empty rectangles
  *
  * \sa SDL_GetRectIntersection
  */
@@ -682,7 +682,7 @@ static int rect_testIntersectRectEmpty(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_GetRectIntersection() with invalid parameters
+ * Negative tests against SDL_GetRectIntersection() with invalid parameters
  *
  * \sa SDL_GetRectIntersection
  */
@@ -711,7 +711,7 @@ static int rect_testIntersectRectParam(void *arg)
 }
 
 /**
- * \brief Tests SDL_HasRectIntersection() with B fully inside A
+ * Tests SDL_HasRectIntersection() with B fully inside A
  *
  * \sa SDL_HasRectIntersection
  */
@@ -737,7 +737,7 @@ static int rect_testHasIntersectionInside(void *arg)
 }
 
 /**
- * \brief Tests SDL_HasRectIntersection() with B fully outside A
+ * Tests SDL_HasRectIntersection() with B fully outside A
  *
  * \sa SDL_HasRectIntersection
  */
@@ -763,7 +763,7 @@ static int rect_testHasIntersectionOutside(void *arg)
 }
 
 /**
- * \brief Tests SDL_HasRectIntersection() with B partially intersecting A
+ * Tests SDL_HasRectIntersection() with B partially intersecting A
  *
  * \sa SDL_HasRectIntersection
  */
@@ -829,7 +829,7 @@ static int rect_testHasIntersectionPartial(void *arg)
 }
 
 /**
- * \brief Tests SDL_HasRectIntersection() with 1x1 pixel sized rectangles
+ * Tests SDL_HasRectIntersection() with 1x1 pixel sized rectangles
  *
  * \sa SDL_HasRectIntersection
  */
@@ -874,7 +874,7 @@ static int rect_testHasIntersectionPoint(void *arg)
 }
 
 /**
- * \brief Tests SDL_HasRectIntersection() with empty rectangles
+ * Tests SDL_HasRectIntersection() with empty rectangles
  *
  * \sa SDL_HasRectIntersection
  */
@@ -931,7 +931,7 @@ static int rect_testHasIntersectionEmpty(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_HasRectIntersection() with invalid parameters
+ * Negative tests against SDL_HasRectIntersection() with invalid parameters
  *
  * \sa SDL_HasRectIntersection
  */
@@ -953,7 +953,7 @@ static int rect_testHasIntersectionParam(void *arg)
 }
 
 /**
- * \brief Test SDL_GetRectEnclosingPoints() without clipping
+ * Test SDL_GetRectEnclosingPoints() without clipping
  *
  * \sa SDL_GetRectEnclosingPoints
  */
@@ -1030,7 +1030,7 @@ static int rect_testEnclosePoints(void *arg)
 }
 
 /**
- * \brief Test SDL_GetRectEnclosingPoints() with repeated input points
+ * Test SDL_GetRectEnclosingPoints() with repeated input points
  *
  * \sa SDL_GetRectEnclosingPoints
  */
@@ -1113,7 +1113,7 @@ static int rect_testEnclosePointsRepeatedInput(void *arg)
 }
 
 /**
- * \brief Test SDL_GetRectEnclosingPoints() with clipping
+ * Test SDL_GetRectEnclosingPoints() with clipping
  *
  * \sa SDL_GetRectEnclosingPoints
  */
@@ -1219,7 +1219,7 @@ static int rect_testEnclosePointsWithClipping(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_GetRectEnclosingPoints() with invalid parameters
+ * Negative tests against SDL_GetRectEnclosingPoints() with invalid parameters
  *
  * \sa SDL_GetRectEnclosingPoints
  */
@@ -1246,7 +1246,7 @@ static int rect_testEnclosePointsParam(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectUnion() where rect B is outside rect A
+ * Tests SDL_GetRectUnion() where rect B is outside rect A
  *
  * \sa SDL_GetRectUnion
  */
@@ -1324,7 +1324,7 @@ static int rect_testUnionRectOutside(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectUnion() where rect A or rect B are empty
+ * Tests SDL_GetRectUnion() where rect A or rect B are empty
  *
  * \sa SDL_GetRectUnion
  */
@@ -1388,7 +1388,7 @@ static int rect_testUnionRectEmpty(void *arg)
 }
 
 /**
- * \brief Tests SDL_GetRectUnion() where rect B is inside rect A
+ * Tests SDL_GetRectUnion() where rect B is inside rect A
  *
  * \sa SDL_GetRectUnion
  */
@@ -1459,7 +1459,7 @@ static int rect_testUnionRectInside(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_GetRectUnion() with invalid parameters
+ * Negative tests against SDL_GetRectUnion() with invalid parameters
  *
  * \sa SDL_GetRectUnion
  */
@@ -1486,7 +1486,7 @@ static int rect_testUnionRectParam(void *arg)
 }
 
 /**
- * \brief Tests SDL_RectEmpty() with various inputs
+ * Tests SDL_RectEmpty() with various inputs
  *
  * \sa SDL_RectEmpty
  */
@@ -1528,7 +1528,7 @@ static int rect_testRectEmpty(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_RectEmpty() with invalid parameters
+ * Negative tests against SDL_RectEmpty() with invalid parameters
  *
  * \sa SDL_RectEmpty
  */
@@ -1544,7 +1544,7 @@ static int rect_testRectEmptyParam(void *arg)
 }
 
 /**
- * \brief Tests SDL_RectsEqual() with various inputs
+ * Tests SDL_RectsEqual() with various inputs
  *
  * \sa SDL_RectsEqual
  */
@@ -1573,7 +1573,7 @@ static int rect_testRectEquals(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_RectsEqual() with invalid parameters
+ * Negative tests against SDL_RectsEqual() with invalid parameters
  *
  * \sa SDL_RectsEqual
  */
@@ -1605,7 +1605,7 @@ static int rect_testRectEqualsParam(void *arg)
 }
 
 /**
- * \brief Tests SDL_RectsEqualFloat() with various inputs
+ * Tests SDL_RectsEqualFloat() with various inputs
  *
  * \sa SDL_RectsEqualFloat
  */
@@ -1634,7 +1634,7 @@ static int rect_testFRectEquals(void *arg)
 }
 
 /**
- * \brief Negative tests against SDL_RectsEqualFloat() with invalid parameters
+ * Negative tests against SDL_RectsEqualFloat() with invalid parameters
  *
  * \sa SDL_RectsEqualFloat
  */
@@ -1804,7 +1804,7 @@ static const SDLTest_TestCaseReference rectTest31 = {
 };
 
 /**
- * \brief Sequence of Rect test cases; functions that handle simple rectangles including overlaps and merges.
+ * Sequence of Rect test cases; functions that handle simple rectangles including overlaps and merges.
  */
 static const SDLTest_TestCaseReference *rectTests[] = {
     &rectTest1, &rectTest2, &rectTest3, &rectTest4, &rectTest5, &rectTest6, &rectTest7, &rectTest8, &rectTest9, &rectTest10, &rectTest11, &rectTest12, &rectTest13, &rectTest14,

test/testautomation_render.c

@@ -90,7 +90,7 @@ static void CleanupDestroyRenderer(void *arg)
 }
 
 /**
- * \brief Tests call to SDL_GetNumRenderDrivers
+ * Tests call to SDL_GetNumRenderDrivers
  *
  * \sa SDL_GetNumRenderDrivers
  */
@@ -103,7 +103,7 @@ static int render_testGetNumRenderDrivers(void *arg)
 }
 
 /**
- * \brief Tests the SDL primitives for rendering.
+ * Tests the SDL primitives for rendering.
  *
  * \sa SDL_SetRenderDrawColor
  * \sa SDL_RenderFillRect
@@ -190,7 +190,7 @@ static int render_testPrimitives(void *arg)
 }
 
 /**
- * \brief Tests the SDL primitives with alpha for rendering.
+ * Tests the SDL primitives with alpha for rendering.
  *
  * \sa SDL_SetRenderDrawColor
  * \sa SDL_SetRenderDrawBlendMode
@@ -333,7 +333,7 @@ static int render_testPrimitivesBlend(void *arg)
 }
 
 /**
- * \brief Tests some blitting routines.
+ * Tests some blitting routines.
  *
  * \sa SDL_RenderTexture
  * \sa SDL_DestroyTexture
@@ -400,7 +400,7 @@ static int render_testBlit(void *arg)
 }
 
 /**
- * \brief Blits doing color tests.
+ * Blits doing color tests.
  *
  * \sa SDL_SetTextureColorMod
  * \sa SDL_RenderTexture
@@ -474,7 +474,7 @@ static int render_testBlitColor(void *arg)
 }
 
 /**
- * \brief Tests blitting with alpha.
+ * Tests blitting with alpha.
  *
  * \sa SDL_SetTextureAlphaMod
  * \sa SDL_RenderTexture
@@ -551,7 +551,7 @@ static int render_testBlitAlpha(void *arg)
 }
 
 /**
- * \brief Tests a blend mode.
+ * Tests a blend mode.
  *
  * \sa SDL_SetTextureBlendMode
  * \sa SDL_RenderTexture
@@ -602,7 +602,7 @@ testBlitBlendMode(SDL_Texture *tface, int mode)
 }
 
 /**
- * \brief Tests some more blitting routines.
+ * Tests some more blitting routines.
  *
  * \sa SDL_SetTextureColorMod
  * \sa SDL_SetTextureAlphaMod
@@ -759,7 +759,7 @@ static int render_testBlitBlend(void *arg)
 }
 
 /**
- * \brief Test viewport
+ * Test viewport
  */
 static int render_testViewport(void *arg)
 {
@@ -816,7 +816,7 @@ static int render_testViewport(void *arg)
 }
 
 /**
- * \brief Test logical size
+ * Test logical size
  */
 static int render_testLogicalSize(void *arg)
 {
@@ -926,7 +926,7 @@ static int render_testLogicalSize(void *arg)
 /* Helper functions */
 
 /**
- * \brief Checks to see if functionality is supported. Helper function.
+ * Checks to see if functionality is supported. Helper function.
  */
 static int
 isSupported(int code)
@@ -935,7 +935,7 @@ isSupported(int code)
 }
 
 /**
- * \brief Test to see if we can vary the draw color. Helper function.
+ * Test to see if we can vary the draw color. Helper function.
  *
  * \sa SDL_SetRenderDrawColor
  * \sa SDL_GetRenderDrawColor
@@ -976,7 +976,7 @@ hasDrawColor(void)
 }
 
 /**
- * \brief Test to see if we can vary the blend mode. Helper function.
+ * Test to see if we can vary the blend mode. Helper function.
  *
  * \sa SDL_SetRenderDrawBlendMode
  * \sa SDL_GetRenderDrawBlendMode
@@ -1043,7 +1043,7 @@ hasBlendModes(void)
 }
 
 /**
- * \brief Loads the test image 'Face' as texture. Helper function.
+ * Loads the test image 'Face' as texture. Helper function.
  *
  * \sa SDL_CreateTextureFromSurface
  */
@@ -1069,7 +1069,7 @@ loadTestFace(void)
 }
 
 /**
- * \brief Test to see if can set texture color mode. Helper function.
+ * Test to see if can set texture color mode. Helper function.
  *
  * \sa SDL_SetTextureColorMod
  * \sa SDL_GetTextureColorMod
@@ -1112,7 +1112,7 @@ hasTexColor(void)
 }
 
 /**
- * \brief Test to see if we can vary the alpha of the texture. Helper function.
+ * Test to see if we can vary the alpha of the texture. Helper function.
  *
  * \sa SDL_SetTextureAlphaMod
  * \sa SDL_GetTextureAlphaMod
@@ -1155,7 +1155,7 @@ hasTexAlpha(void)
 }
 
 /**
- * \brief Compares screen pixels with image pixels. Helper function.
+ * Compares screen pixels with image pixels. Helper function.
  *
  * \param referenceSurface Image to compare against.
  * \param allowable_error allowed difference from the reference image
@@ -1200,7 +1200,7 @@ compare(SDL_Surface *referenceSurface, int allowable_error)
 }
 
 /**
- * \brief Clears the screen. Helper function.
+ * Clears the screen. Helper function.
  *
  * \sa SDL_SetRenderDrawColor
  * \sa SDL_RenderClear

test/testautomation_rwops.c

@@ -90,7 +90,7 @@ static void RWopsTearDown(void *arg)
 }
 
 /**
- * \brief Makes sure parameters work properly. Local helper function.
+ * Makes sure parameters work properly. Local helper function.
  *
  * \sa SDL_RWseek
  * \sa SDL_RWread
@@ -245,7 +245,7 @@ static int rwops_testParamNegative(void *arg)
 }
 
 /**
- * \brief Tests opening from memory.
+ * Tests opening from memory.
  *
  * \sa SDL_RWFromMem
  * \sa SDL_RWClose
@@ -284,7 +284,7 @@ static int rwops_testMem(void *arg)
 }
 
 /**
- * \brief Tests opening from memory.
+ * Tests opening from memory.
  *
  * \sa SDL_RWFromConstMem
  * \sa SDL_RWClose
@@ -319,7 +319,7 @@ static int rwops_testConstMem(void *arg)
 }
 
 /**
- * \brief Tests reading from file.
+ * Tests reading from file.
  *
  * \sa SDL_RWFromFile
  * \sa SDL_RWClose
@@ -366,7 +366,7 @@ static int rwops_testFileRead(void *arg)
 }
 
 /**
- * \brief Tests writing from file.
+ * Tests writing from file.
  *
  * \sa SDL_RWFromFile
  * \sa SDL_RWClose
@@ -413,7 +413,7 @@ static int rwops_testFileWrite(void *arg)
 }
 
 /**
- * \brief Tests alloc and free RW context.
+ * Tests alloc and free RW context.
  *
  * \sa SDL_CreateRW
  * \sa SDL_DestroyRW
@@ -441,7 +441,7 @@ static int rwops_testAllocFree(void *arg)
 }
 
 /**
- * \brief Compare memory and file reads
+ * Compare memory and file reads
  *
  * \sa SDL_RWFromMem
  * \sa SDL_RWFromFile
@@ -504,7 +504,7 @@ static int rwops_testCompareRWFromMemWithRWFromFile(void *arg)
 }
 
 /**
- * \brief Tests writing and reading from file using endian aware functions.
+ * Tests writing and reading from file using endian aware functions.
  *
  * \sa SDL_RWFromFile
  * \sa SDL_RWClose

test/testautomation_sdltest.c

@@ -12,7 +12,7 @@
 /* Test case functions */
 
 /**
- * \brief Calls to SDLTest_GenerateRunSeed()
+ * Calls to SDLTest_GenerateRunSeed()
  */
 static int sdltest_generateRunSeed(void *arg)
 {
@@ -42,7 +42,7 @@ static int sdltest_generateRunSeed(void *arg)
 }
 
 /**
- * \brief Calls to SDLTest_GetFuzzerInvocationCount()
+ * Calls to SDLTest_GetFuzzerInvocationCount()
  */
 static int sdltest_getFuzzerInvocationCount(void *arg)
 {
@@ -64,7 +64,7 @@ static int sdltest_getFuzzerInvocationCount(void *arg)
 }
 
 /**
- * \brief Calls to random number generators
+ * Calls to random number generators
  */
 static int sdltest_randomNumber(void *arg)
 {
@@ -131,7 +131,7 @@ static int sdltest_randomNumber(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Uint8
+ * Calls to random boundary number generators for Uint8
  */
 static int sdltest_randomBoundaryNumberUint8(void *arg)
 {
@@ -240,7 +240,7 @@ static int sdltest_randomBoundaryNumberUint8(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Uint16
+ * Calls to random boundary number generators for Uint16
  */
 static int sdltest_randomBoundaryNumberUint16(void *arg)
 {
@@ -349,7 +349,7 @@ static int sdltest_randomBoundaryNumberUint16(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Uint32
+ * Calls to random boundary number generators for Uint32
  */
 static int sdltest_randomBoundaryNumberUint32(void *arg)
 {
@@ -458,7 +458,7 @@ static int sdltest_randomBoundaryNumberUint32(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Uint64
+ * Calls to random boundary number generators for Uint64
  */
 static int sdltest_randomBoundaryNumberUint64(void *arg)
 {
@@ -567,7 +567,7 @@ static int sdltest_randomBoundaryNumberUint64(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Sint8
+ * Calls to random boundary number generators for Sint8
  */
 static int sdltest_randomBoundaryNumberSint8(void *arg)
 {
@@ -676,7 +676,7 @@ static int sdltest_randomBoundaryNumberSint8(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Sint16
+ * Calls to random boundary number generators for Sint16
  */
 static int sdltest_randomBoundaryNumberSint16(void *arg)
 {
@@ -785,7 +785,7 @@ static int sdltest_randomBoundaryNumberSint16(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Sint32
+ * Calls to random boundary number generators for Sint32
  */
 static int sdltest_randomBoundaryNumberSint32(void *arg)
 {
@@ -901,7 +901,7 @@ static int sdltest_randomBoundaryNumberSint32(void *arg)
 }
 
 /**
- * \brief Calls to random boundary number generators for Sint64
+ * Calls to random boundary number generators for Sint64
  */
 static int sdltest_randomBoundaryNumberSint64(void *arg)
 {
@@ -1010,7 +1010,7 @@ static int sdltest_randomBoundaryNumberSint64(void *arg)
 }
 
 /**
- * \brief Calls to SDLTest_RandomIntegerInRange
+ * Calls to SDLTest_RandomIntegerInRange
  */
 static int sdltest_randomIntegerInRange(void *arg)
 {
@@ -1084,7 +1084,7 @@ static int sdltest_randomIntegerInRange(void *arg)
 }
 
 /**
- * \brief Calls to SDLTest_RandomAsciiString
+ * Calls to SDLTest_RandomAsciiString
  */
 static int sdltest_randomAsciiString(void *arg)
 {
@@ -1116,7 +1116,7 @@ static int sdltest_randomAsciiString(void *arg)
 }
 
 /**
- * \brief Calls to SDLTest_RandomAsciiStringWithMaximumLength
+ * Calls to SDLTest_RandomAsciiStringWithMaximumLength
  */
 static int sdltest_randomAsciiStringWithMaximumLength(void *arg)
 {
@@ -1168,7 +1168,7 @@ static int sdltest_randomAsciiStringWithMaximumLength(void *arg)
 }
 
 /**
- * \brief Calls to SDLTest_RandomAsciiStringOfSize
+ * Calls to SDLTest_RandomAsciiStringOfSize
  */
 static int sdltest_randomAsciiStringOfSize(void *arg)
 {

test/testautomation_stdlib.c

@@ -8,7 +8,7 @@
 /* Test case functions */
 
 /**
- * \brief Call to SDL_strnlen
+ * Call to SDL_strnlen
  */
 #undef SDL_strnlen
 static int stdlib_strnlen(void *arg)
@@ -36,7 +36,7 @@ static int stdlib_strnlen(void *arg)
 }
 
 /**
- * \brief Call to SDL_strlcpy
+ * Call to SDL_strlcpy
  */
 #undef SDL_strlcpy
 static int stdlib_strlcpy(void *arg)
@@ -71,7 +71,7 @@ static int stdlib_strlcpy(void *arg)
 #endif
 
 /**
- * \brief Call to SDL_snprintf
+ * Call to SDL_snprintf
  */
 #undef SDL_snprintf
 static int stdlib_snprintf(void *arg)
@@ -262,7 +262,7 @@ static int stdlib_snprintf(void *arg)
 }
 
 /**
- * \brief Call to SDL_swprintf
+ * Call to SDL_swprintf
  */
 #undef SDL_swprintf
 static int stdlib_swprintf(void *arg)
@@ -429,7 +429,7 @@ static int stdlib_swprintf(void *arg)
 #endif
 
 /**
- * \brief Call to SDL_getenv and SDL_setenv
+ * Call to SDL_getenv and SDL_setenv
  */
 static int stdlib_getsetenv(void *arg)
 {
@@ -572,7 +572,7 @@ static int stdlib_getsetenv(void *arg)
 #endif
 
 /**
- * \brief Call to SDL_sscanf
+ * Call to SDL_sscanf
  */
 #undef SDL_sscanf
 static int stdlib_sscanf(void *arg)
@@ -741,7 +741,7 @@ static int stdlib_sscanf(void *arg)
 #endif
 
 /**
- * \brief Call to SDL_aligned_alloc
+ * Call to SDL_aligned_alloc
  */
 static int stdlib_aligned_alloc(void *arg)
 {

test/testautomation_subsystems.c

@@ -34,7 +34,7 @@ static void subsystemsTearDown(void *arg)
 /* Test case functions */
 
 /**
- * \brief Inits and Quits particular subsystem, checking its Init status.
+ * Inits and Quits particular subsystem, checking its Init status.
  *
  * \sa SDL_InitSubSystem
  * \sa SDL_QuitSubSystem
@@ -83,7 +83,7 @@ static int subsystems_referenceCount()
 }
 
 /**
- * \brief Inits and Quits subsystems that have another as dependency;
+ * Inits and Quits subsystems that have another as dependency;
  *        check that the dependency is not removed before the last of its dependents.
  *
  * \sa SDL_InitSubSystem
@@ -121,7 +121,7 @@ static int subsystems_dependRefCountInitAllQuitByOne()
 }
 
 /**
- * \brief Inits and Quits subsystems that have another as dependency;
+ * Inits and Quits subsystems that have another as dependency;
  *        check that the dependency is not removed before the last of its dependents.
  *
  * \sa SDL_InitSubSystem
@@ -155,7 +155,7 @@ static int subsystems_dependRefCountInitByOneQuitAll()
 }
 
 /**
- * \brief Inits and Quits subsystems that have another as dependency,
+ * Inits and Quits subsystems that have another as dependency,
  *        but also inits that dependency explicitly, giving it extra ref count.
  *        Check that the dependency is not removed before the last reference is gone.
  *

test/testautomation_surface.c

@@ -209,7 +209,7 @@ static void AssertFileExist(const char *filename)
 /* Test case functions */
 
 /**
- * \brief Tests sprite saving and loading
+ * Tests sprite saving and loading
  */
 static int surface_testSaveLoadBitmap(void *arg)
 {
@@ -389,7 +389,7 @@ static int surface_testCompleteSurfaceConversion(void *arg)
 }
 
 /**
- * \brief Tests sprite loading. A failure case.
+ * Tests sprite loading. A failure case.
  */
 static int surface_testLoadFailure(void *arg)
 {
@@ -400,7 +400,7 @@ static int surface_testLoadFailure(void *arg)
 }
 
 /**
- * \brief Tests some blitting routines.
+ * Tests some blitting routines.
  */
 static int surface_testBlit(void *arg)
 {
@@ -422,7 +422,7 @@ static int surface_testBlit(void *arg)
 }
 
 /**
- * \brief Tests some blitting routines with color mod
+ * Tests some blitting routines with color mod
  */
 static int surface_testBlitColorMod(void *arg)
 {
@@ -444,7 +444,7 @@ static int surface_testBlitColorMod(void *arg)
 }
 
 /**
- * \brief Tests some blitting routines with alpha mod
+ * Tests some blitting routines with alpha mod
  */
 static int surface_testBlitAlphaMod(void *arg)
 {
@@ -466,7 +466,7 @@ static int surface_testBlitAlphaMod(void *arg)
 }
 
 /**
- * \brief Tests some more blitting routines.
+ * Tests some more blitting routines.
  */
 static int surface_testBlitBlendNone(void *arg)
 {
@@ -488,7 +488,7 @@ static int surface_testBlitBlendNone(void *arg)
 }
 
 /**
- * \brief Tests some more blitting routines.
+ * Tests some more blitting routines.
  */
 static int surface_testBlitBlendBlend(void *arg)
 {
@@ -510,7 +510,7 @@ static int surface_testBlitBlendBlend(void *arg)
 }
 
 /**
- * \brief Tests some more blitting routines.
+ * Tests some more blitting routines.
  */
 static int surface_testBlitBlendAdd(void *arg)
 {
@@ -532,7 +532,7 @@ static int surface_testBlitBlendAdd(void *arg)
 }
 
 /**
- * \brief Tests some more blitting routines.
+ * Tests some more blitting routines.
  */
 static int surface_testBlitBlendMod(void *arg)
 {
@@ -554,7 +554,7 @@ static int surface_testBlitBlendMod(void *arg)
 }
 
 /**
- * \brief Tests some more blitting routines with loop
+ * Tests some more blitting routines with loop
  */
 static int surface_testBlitBlendLoop(void *arg)
 {

test/testautomation_syswm.c

@@ -13,7 +13,7 @@
 /* Test case functions */
 
 /**
- * \brief Call to SDL_GetWindowWMInfo
+ * Call to SDL_GetWindowWMInfo
  */
 static int syswm_getWindowWMInfo(void *arg)
 {