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.
2025-12-14 19:05:28 +08:00 · 2023-11-06 10:26:06 -05:00
parent c132295ad7
commit c53843a961
104 changed files with 669 additions and 667 deletions
--- a/include/SDL3/SDL_assert.h
+++ b/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_
--- a/include/SDL3/SDL_atomic.h
+++ b/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
- *        so people don't accidentally use numeric operations on it.
+ * A type representing an atomic integer value.
+ *
+ * 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
--- a/include/SDL3/SDL_audio.h
+++ b/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).
--- a/include/SDL3/SDL_bits.h
+++ b/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_
--- a/include/SDL3/SDL_blendmode.h
+++ b/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
 {
--- a/include/SDL3/SDL_clipboard.h
+++ b/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_
--- a/include/SDL3/SDL_copying.h
+++ b/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.
 */
--- a/include/SDL3/SDL_cpuinfo.h
+++ b/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_
--- a/include/SDL3/SDL_egl.h
+++ b/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)
--- a/include/SDL3/SDL_endian.h
+++ b/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_
--- a/include/SDL3/SDL_events.h
+++ b/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.*)
- *         This event is disabled by default, you can enable it with SDL_SetEventEnabled()
+ * A video driver dependent system event (event.syswm.*)
 *
- *  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.
+ * This event is disabled by default, you can enable it with
+ * 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
 {
--- a/include/SDL3/SDL_filesystem.h
+++ b/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_
--- a/include/SDL3/SDL_gamepad.h
+++ b/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_
--- a/include/SDL3/SDL_guid.h
+++ b/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_
--- a/include/SDL3/SDL_haptic.h
+++ b/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)
- *         devices.
+ *  The SDL haptic subsystem manages haptic (force feedback) 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 
- *  provides better compatibility across platforms and devices as SDL will guess 
- *  the correct axis.
- *  \sa SDL_HapticDirection
+ * Use this value to play an effect on the steering wheel axis.
+ *
+ * This provides better compatibility across platforms and devices as SDL
+ * 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.
--- a/include/SDL3/SDL_hidapi.h
+++ b/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
 {
--- a/include/SDL3/SDL_hints.h
+++ b/include/SDL3/SDL_hints.h
--- a/include/SDL3/SDL_init.h
+++ b/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.
--- a/include/SDL3/SDL_intrin.h
+++ b/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_
--- a/include/SDL3/SDL_joystick.h
+++ b/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

--- a/include/SDL3/SDL_keyboard.h
+++ b/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.
 */
--- a/include/SDL3/SDL_keycode.h
+++ b/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
 {
--- a/include/SDL3/SDL_loadso.h
+++ b/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
--- a/include/SDL3/SDL_locale.h
+++ b/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
--- a/include/SDL3/SDL_log.h
+++ b/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
 {
--- a/include/SDL3/SDL_main.h
+++ b/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
--- a/include/SDL3/SDL_metal.h
+++ b/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.
 */
--- a/include/SDL3/SDL_misc.h
+++ b/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_
--- a/include/SDL3/SDL_mouse.h
+++ b/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
 {
--- a/include/SDL3/SDL_mutex.h
+++ b/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>
--- a/include/SDL3/SDL_oldnames.h
+++ b/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_
--- a/include/SDL3/SDL_opengl.h
+++ b/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.
 */

 /**
--- a/include/SDL3/SDL_opengles.h
+++ b/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>

--- a/include/SDL3/SDL_opengles2.h
+++ b/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>

--- a/include/SDL3/SDL_pixels.h
+++ b/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:
 *
--- a/include/SDL3/SDL_platform.h
+++ b/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_
--- a/include/SDL3/SDL_platform_defines.h
+++ b/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_
--- a/include/SDL3/SDL_power.h
+++ b/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>
--- a/include/SDL3/SDL_properties.h
+++ b/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_
--- a/include/SDL3/SDL_quit.h
+++ b/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_
--- a/include/SDL3/SDL_rect.h
+++ b/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_
--- a/include/SDL3/SDL_render.h
+++ b/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
--- a/include/SDL3/SDL_revision.h
+++ b/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_
--- a/include/SDL3/SDL_scancode.h
+++ b/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
--- a/include/SDL3/SDL_sensor.h
+++ b/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
--- a/include/SDL3/SDL_shape.h
+++ b/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;

--- a/include/SDL3/SDL_stdinc.h
+++ b/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 */
--- a/include/SDL3/SDL_surface.h
+++ b/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
 {
--- a/include/SDL3/SDL_system.h
+++ b/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;

--- a/include/SDL3/SDL_syswm.h
+++ b/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
--- a/Show More
+++ b/Show More