Sync SDL3 wiki -> headers

2026-05-26 10:06:42 +08:00 · 2024-04-09 00:49:23 -04:00
parent ad090d2444
commit e044318a8e
33 changed files with 1510 additions and 909 deletions
@@ -129,8 +129,8 @@ typedef enum
 * Information about an assertion failure.
 *
 * This structure is filled in with information about a triggered assertion,
- * used by the assertion handler, then added to the assertion report.
- * This is returned as a linked list from SDL_GetAssertionReport().
+ * used by the assertion handler, then added to the assertion report. This is
+ * returned as a linked list from SDL_GetAssertionReport().
 *
 * \since This struct is available since SDL 3.0.0.
 */
@@ -149,9 +149,9 @@ typedef Uint32 SDL_AudioDeviceID;
 /**
 * Format specifier for audio data.
 *
- * \sa SDL_AudioFormat
- *
 * \since This struct is available since SDL 3.0.0.
+ *
+ * \sa SDL_AudioFormat
 */
 typedef struct SDL_AudioSpec
 {
@@ -168,19 +168,19 @@ typedef struct SDL_AudioSpec
 *
 * SDL_AudioStream is an audio conversion interface.
 *
- * - It can handle resampling data in chunks without generating
- *   artifacts, when it doesn't have the complete buffer available.
+ * - It can handle resampling data in chunks without generating artifacts,
+ *   when it doesn't have the complete buffer available.
 * - It can handle incoming data in any variable size.
 * - It can handle input/output format changes on the fly.
 * - You push data as you have it, and pull it when you need it
- * - It can also function as a basic audio data queue even if you
- *   just have sound that needs to pass from one place to another.
- * - You can hook callbacks up to them when more data is added or
- *   requested, to manage data on-the-fly.
+ * - It can also function as a basic audio data queue even if you just have
+ *   sound that needs to pass from one place to another.
+ * - You can hook callbacks up to them when more data is added or requested,
+ *   to manage data on-the-fly.
 *
- * Audio streams are the core of the SDL3 audio interface. You create
- * one or more of them, bind them to an opened audio device, and feed
- * data to them (or for recording, consume data from them).
+ * Audio streams are the core of the SDL3 audio interface. You create one or
+ * more of them, bind them to an opened audio device, and feed data to them
+ * (or for recording, consume data from them).
 *
 * \since This struct is available since SDL 3.0.0.
 *
@@ -37,11 +37,12 @@ extern "C" {
 /**
 * An enumeration of blend modes used in drawing operations.
 *
- * Note that additional values may be obtained from SDL_ComposeCustomBlendMode.
- *
- * \sa SDL_ComposeCustomBlendMode
+ * Note that additional values may be obtained from
+ * SDL_ComposeCustomBlendMode.
 *
 * \since This enum is available since SDL 3.0.0.
+ *
+ * \sa SDL_ComposeCustomBlendMode
 */
 typedef enum SDL_BlendMode
 {
@@ -66,7 +67,8 @@ typedef enum SDL_BlendMode
 } SDL_BlendMode;

 /**
- * The blend operation used when combining source and destination pixel components.
+ * The blend operation used when combining source and destination pixel
+ * components.
 *
 * \since This enum is available since SDL 3.0.0.
 */
@@ -82,10 +84,10 @@ typedef enum SDL_BlendOperation
 /**
 * The normalized factor used to multiply pixel components.
 *
- * The blend factors are multiplied with the pixels from a drawing
- * operation (src) and the pixels from the render target (dst) before
- * the blend operation. The comma-separated factors listed above are always
- * applied in the component order red, green, blue, and alpha.
+ * The blend factors are multiplied with the pixels from a drawing operation
+ * (src) and the pixels from the render target (dst) before the blend
+ * operation. The comma-separated factors listed above are always applied in
+ * the component order red, green, blue, and alpha.
 *
 * \since This enum is available since SDL 3.0.0.
 */
@@ -59,12 +59,13 @@ typedef struct SDL_Camera SDL_Camera;
 /**
 * The details of an output format for a camera device.
 *
- * Cameras often support multiple formats; each one will be encapsulated in this struct.
+ * Cameras often support multiple formats; each one will be encapsulated in
+ * this struct.
+ *
+ * \since This struct is available since SDL 3.0.0.
 *
 * \sa SDL_GetCameraDeviceSupportedFormats
 * \sa SDL_GetCameraFormat
- *
- * \since This struct is available since SDL 3.0.0.
 */
 typedef struct SDL_CameraSpec
 {
@@ -78,9 +79,9 @@ typedef struct SDL_CameraSpec
 /**
 * The position of camera in relation to system device.
 *
- * \sa SDL_GetCameraDevicePosition
- *
 * \since This enum is available since SDL 3.0.0.
+ *
+ * \sa SDL_GetCameraDevicePosition
 */
 typedef enum SDL_CameraPosition
 {
@@ -34,7 +34,8 @@ extern "C" {
 /**
 * An entry for filters for file dialogs.
 *
- * `name` is a user-readable label for the filter (for example, "Office document").
+ * `name` is a user-readable label for the filter (for example, "Office
+ * document").
 *
 * `pattern` is a semicolon-separated list of file extensions (for example,
 * "doc;docx"). File extensions may only contain alphanumeric characters,
@@ -240,7 +240,7 @@ typedef enum SDL_EventType
 } SDL_EventType;

 /**
- *  Fields shared by every event
+ * Fields shared by every event
 */
 typedef struct SDL_CommonEvent
 {
@@ -250,7 +250,7 @@ typedef struct SDL_CommonEvent
 } SDL_CommonEvent;

 /**
- *  Display state change event data (event.display.*)
+ * Display state change event data (event.display.*)
 */
 typedef struct SDL_DisplayEvent
 {
@@ -262,7 +262,7 @@ typedef struct SDL_DisplayEvent
 } SDL_DisplayEvent;

 /**
- *  Window state change event data (event.window.*)
+ * Window state change event data (event.window.*)
 */
 typedef struct SDL_WindowEvent
 {
@@ -275,7 +275,7 @@ typedef struct SDL_WindowEvent
 } SDL_WindowEvent;

 /**
- *  Keyboard device event structure (event.kdevice.*)
+ * Keyboard device event structure (event.kdevice.*)
 */
 typedef struct SDL_KeyboardDeviceEvent
 {
@@ -286,7 +286,7 @@ typedef struct SDL_KeyboardDeviceEvent
 } SDL_KeyboardDeviceEvent;

 /**
- *  Keyboard button event structure (event.key.*)
+ * Keyboard button event structure (event.key.*)
 */
 typedef struct SDL_KeyboardEvent
 {
@@ -303,11 +303,12 @@ typedef struct SDL_KeyboardEvent
 } SDL_KeyboardEvent;

 #define SDL_TEXTEDITINGEVENT_TEXT_SIZE 64
+
 /**
- *  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.
+ * 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.
 */
 typedef struct SDL_TextEditingEvent
 {
@@ -321,10 +322,10 @@ typedef struct SDL_TextEditingEvent
 } SDL_TextEditingEvent;

 /**
- *  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.
+ * 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.
 */
 typedef struct SDL_TextInputEvent
 {
@@ -336,7 +337,7 @@ typedef struct SDL_TextInputEvent
 } SDL_TextInputEvent;

 /**
- *  Mouse device event structure (event.mdevice.*)
+ * Mouse device event structure (event.mdevice.*)
 */
 typedef struct SDL_MouseDeviceEvent
 {
@@ -347,7 +348,7 @@ typedef struct SDL_MouseDeviceEvent
 } SDL_MouseDeviceEvent;

 /**
- *  Mouse motion event structure (event.motion.*)
+ * Mouse motion event structure (event.motion.*)
 */
 typedef struct SDL_MouseMotionEvent
 {
@@ -364,7 +365,7 @@ typedef struct SDL_MouseMotionEvent
 } SDL_MouseMotionEvent;

 /**
- *  Mouse button event structure (event.button.*)
+ * Mouse button event structure (event.button.*)
 */
 typedef struct SDL_MouseButtonEvent
 {
@@ -382,7 +383,7 @@ typedef struct SDL_MouseButtonEvent
 } SDL_MouseButtonEvent;

 /**
- *  Mouse wheel event structure (event.wheel.*)
+ * Mouse wheel event structure (event.wheel.*)
 */
 typedef struct SDL_MouseWheelEvent
 {
@@ -399,7 +400,7 @@ typedef struct SDL_MouseWheelEvent
 } SDL_MouseWheelEvent;

 /**
- *  Joystick axis motion event structure (event.jaxis.*)
+ * Joystick axis motion event structure (event.jaxis.*)
 */
 typedef struct SDL_JoyAxisEvent
 {
@@ -416,7 +417,7 @@ typedef struct SDL_JoyAxisEvent
 } SDL_JoyAxisEvent;

 /**
- *  \brief Joystick trackball motion event structure (event.jball.*)
+ * Joystick trackball motion event structure (event.jball.*)
 */
 typedef struct SDL_JoyBallEvent
 {
@@ -433,7 +434,7 @@ typedef struct SDL_JoyBallEvent
 } SDL_JoyBallEvent;

 /**
- *  Joystick hat position change event structure (event.jhat.*)
+ * Joystick hat position change event structure (event.jhat.*)
 */
 typedef struct SDL_JoyHatEvent
 {
@@ -454,7 +455,7 @@ typedef struct SDL_JoyHatEvent
 } SDL_JoyHatEvent;

 /**
- *  Joystick button event structure (event.jbutton.*)
+ * Joystick button event structure (event.jbutton.*)
 */
 typedef struct SDL_JoyButtonEvent
 {
@@ -469,7 +470,7 @@ typedef struct SDL_JoyButtonEvent
 } SDL_JoyButtonEvent;

 /**
- *  Joystick device event structure (event.jdevice.*)
+ * Joystick device event structure (event.jdevice.*)
 */
 typedef struct SDL_JoyDeviceEvent
 {
@@ -480,7 +481,7 @@ typedef struct SDL_JoyDeviceEvent
 } SDL_JoyDeviceEvent;

 /**
- *  Joysick battery level change event structure (event.jbattery.*)
+ * Joysick battery level change event structure (event.jbattery.*)
 */
 typedef struct SDL_JoyBatteryEvent
 {
@@ -493,7 +494,7 @@ typedef struct SDL_JoyBatteryEvent
 } SDL_JoyBatteryEvent;

 /**
- *  Gamepad axis motion event structure (event.gaxis.*)
+ * Gamepad axis motion event structure (event.gaxis.*)
 */
 typedef struct SDL_GamepadAxisEvent
 {
@@ -511,7 +512,7 @@ typedef struct SDL_GamepadAxisEvent


 /**
- *  Gamepad button event structure (event.gbutton.*)
+ * Gamepad button event structure (event.gbutton.*)
 */
 typedef struct SDL_GamepadButtonEvent
 {
@@ -527,7 +528,7 @@ typedef struct SDL_GamepadButtonEvent


 /**
- *  Gamepad device event structure (event.gdevice.*)
+ * Gamepad device event structure (event.gdevice.*)
 */
 typedef struct SDL_GamepadDeviceEvent
 {
@@ -538,7 +539,7 @@ typedef struct SDL_GamepadDeviceEvent
 } SDL_GamepadDeviceEvent;

 /**
- *  Gamepad touchpad event structure (event.gtouchpad.*)
+ * Gamepad touchpad event structure (event.gtouchpad.*)
 */
 typedef struct SDL_GamepadTouchpadEvent
 {
@@ -554,7 +555,7 @@ typedef struct SDL_GamepadTouchpadEvent
 } SDL_GamepadTouchpadEvent;

 /**
- *  Gamepad sensor event structure (event.gsensor.*)
+ * Gamepad sensor event structure (event.gsensor.*)
 */
 typedef struct SDL_GamepadSensorEvent
 {
@@ -568,7 +569,7 @@ typedef struct SDL_GamepadSensorEvent
 } SDL_GamepadSensorEvent;

 /**
- *  Audio device event structure (event.adevice.*)
+ * Audio device event structure (event.adevice.*)
 */
 typedef struct SDL_AudioDeviceEvent
 {
@@ -583,7 +584,7 @@ typedef struct SDL_AudioDeviceEvent
 } SDL_AudioDeviceEvent;

 /**
- *  Camera device event structure (event.cdevice.*)
+ * Camera device event structure (event.cdevice.*)
 */
 typedef struct SDL_CameraDeviceEvent
 {
@@ -597,7 +598,7 @@ typedef struct SDL_CameraDeviceEvent
 } SDL_CameraDeviceEvent;

 /**
- *  Touch finger event structure (event.tfinger.*)
+ * Touch finger event structure (event.tfinger.*)
 */
 typedef struct SDL_TouchFingerEvent
 {
@@ -616,8 +617,9 @@ typedef struct SDL_TouchFingerEvent


 #define SDL_DROPEVENT_DATA_SIZE 64
+
 /**
- *  Pressure-sensitive pen touched or stopped touching surface (event.ptip.*)
+ * Pressure-sensitive pen touched or stopped touching surface (event.ptip.*)
 */
 typedef struct SDL_PenTipEvent
 {
@@ -635,7 +637,8 @@ typedef struct SDL_PenTipEvent
 } SDL_PenTipEvent;

 /**
- *  Pressure-sensitive pen motion / pressure / angle event structure (event.pmotion.*)
+ * Pressure-sensitive pen motion / pressure / angle event structure
+ * (event.pmotion.*)
 */
 typedef struct SDL_PenMotionEvent
 {
@@ -653,7 +656,7 @@ typedef struct SDL_PenMotionEvent
 } SDL_PenMotionEvent;

 /**
- *  Pressure-sensitive pen button event structure (event.pbutton.*)
+ * Pressure-sensitive pen button event structure (event.pbutton.*)
 */
 typedef struct SDL_PenButtonEvent
 {
@@ -671,10 +674,11 @@ typedef struct SDL_PenButtonEvent
 } SDL_PenButtonEvent;

 /**
- * 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. Do not free it!
+ * 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. Do not free it!
 */
 typedef struct SDL_DropEvent
 {
@@ -689,7 +693,8 @@ typedef struct SDL_DropEvent
 } SDL_DropEvent;

 /**
- * 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
 {
@@ -699,7 +704,7 @@ typedef struct SDL_ClipboardEvent
 } SDL_ClipboardEvent;

 /**
- *  Sensor event structure (event.sensor.*)
+ * Sensor event structure (event.sensor.*)
 */
 typedef struct SDL_SensorEvent
 {
@@ -712,7 +717,7 @@ typedef struct SDL_SensorEvent
 } SDL_SensorEvent;

 /**
- *  The "quit requested" event
+ * The "quit requested" event
 */
 typedef struct SDL_QuitEvent
 {
@@ -726,9 +731,9 @@ typedef struct SDL_QuitEvent
 *
 * This event is unique; it is never created by SDL, but only by the
 * application. The event can be pushed onto the event queue using
- * SDL_PushEvent(). The contents of the structure members are completely
- * up to the programmer; the only requirement is that '''type''' is a value
- * obtained from SDL_RegisterEvents().
+ * SDL_PushEvent(). The contents of the structure members are completely up to
+ * the programmer; the only requirement is that '''type''' is a value obtained
+ * from SDL_RegisterEvents().
 */
 typedef struct SDL_UserEvent
 {
@@ -142,9 +142,9 @@ extern DECLSPEC char *SDLCALL SDL_GetPrefPath(const char *org, const char *app);
 /**
 * The type of the OS-provided default folder for a specific purpose.
 *
- * Note that the Trash folder isn't included here, because trashing files usually
- * involves extra OS-specific functionality to remember the file's original
- * location.
+ * Note that the Trash folder isn't included here, because trashing files
+ * usually involves extra OS-specific functionality to remember the file's
+ * original location.
 *
 * The folders supported per platform are:
 *
@@ -76,24 +76,25 @@ typedef enum SDL_GamepadType
 } SDL_GamepadType;

 /**
- *  The list of buttons available on a gamepad
+ * The list of buttons available on a gamepad
 *
- *  For controllers that use a diamond pattern for the face buttons,
- *  the south/east/west/north buttons below correspond to the locations
- *  in the diamond pattern. For Xbox controllers, this would be A/B/X/Y,
- *  for Nintendo Switch controllers, this would be B/A/Y/X, for
- *  PlayStation controllers this would be Cross/Circle/Square/Triangle.
+ * For controllers that use a diamond pattern for the face buttons, the
+ * south/east/west/north buttons below correspond to the locations in the
+ * diamond pattern. For Xbox controllers, this would be A/B/X/Y, for Nintendo
+ * Switch controllers, this would be B/A/Y/X, for PlayStation controllers this
+ * would be Cross/Circle/Square/Triangle.
 *
- *  For controllers that don't use a diamond pattern for the face buttons,
- *  the south/east/west/north buttons indicate the buttons labeled A, B,
- *  C, D, or 1, 2, 3, 4, or for controllers that aren't labeled, they are
- *  the primary, secondary, etc. buttons.
+ * For controllers that don't use a diamond pattern for the face buttons, the
+ * south/east/west/north buttons indicate the buttons labeled A, B, C, D, or
+ * 1, 2, 3, 4, or for controllers that aren't labeled, they are the primary,
+ * secondary, etc. buttons.
 *
- *  The activate action is often the south button and the cancel action
- *  is often the east button, but in some regions this is reversed, so
- *  your game should allow remapping actions based on user preferences.
+ * The activate action is often the south button and the cancel action is
+ * often the east button, but in some regions this is reversed, so your game
+ * should allow remapping actions based on user preferences.
 *
- *  You can query the labels for the face buttons using SDL_GetGamepadButtonLabel()
+ * You can query the labels for the face buttons using
+ * SDL_GetGamepadButtonLabel()
 */
 typedef enum SDL_GamepadButton
 {
@@ -128,11 +129,13 @@ typedef enum SDL_GamepadButton
 } SDL_GamepadButton;

 /**
- *  The set of gamepad button labels
+ * The set of gamepad button labels
 *
- *  This isn't a complete set, just the face buttons to make it easy to show button prompts.
+ * This isn't a complete set, just the face buttons to make it easy to show
+ * button prompts.
 *
- *  For a complete set, you should look at the button and gamepad type and have a set of symbols that work well with your art style.
+ * For a complete set, you should look at the button and gamepad type and have
+ * a set of symbols that work well with your art style.
 */
 typedef enum SDL_GamepadButtonLabel
 {
@@ -148,15 +151,16 @@ typedef enum SDL_GamepadButtonLabel
 } SDL_GamepadButtonLabel;

 /**
- *  The list of axes available on a gamepad
+ * The list of axes available on a gamepad
 *
- *  Thumbstick axis values range from SDL_JOYSTICK_AXIS_MIN to SDL_JOYSTICK_AXIS_MAX,
- *  and are centered within ~8000 of zero, though advanced UI will allow users to set
- *  or autodetect the dead zone, which varies between gamepads.
+ * Thumbstick axis values range from SDL_JOYSTICK_AXIS_MIN to
+ * SDL_JOYSTICK_AXIS_MAX, and are centered within ~8000 of zero, though
+ * advanced UI will allow users to set or autodetect the dead zone, which
+ * varies between gamepads.
 *
- *  Trigger axis values range from 0 (released) to SDL_JOYSTICK_AXIS_MAX
- *  (fully pressed) when reported by SDL_GetGamepadAxis(). Note that this is not the
- *  same range that will be reported by the lower-level SDL_GetJoystickAxis().
+ * Trigger axis values range from 0 (released) to SDL_JOYSTICK_AXIS_MAX (fully
+ * pressed) when reported by SDL_GetGamepadAxis(). Note that this is not the
+ * same range that will be reported by the lower-level SDL_GetJoystickAxis().
 */
 typedef enum SDL_GamepadAxis
 {
@@ -38,19 +38,19 @@ extern "C" {
 #endif

 /**
- * An SDL_GUID is a 128-bit identifier for an input device that
- *   identifies that device across runs of SDL programs on the same
- *   platform.  If the device is detached and then re-attached to a
- *   different port, or if the base system is rebooted, the device
- *   should still report the same GUID.
+ * An SDL_GUID is a 128-bit identifier for an input device that identifies
+ * that device across runs of SDL programs on the same platform.
 *
- * GUIDs are as precise as possible but are not guaranteed to
- *   distinguish physically distinct but equivalent devices.  For
- *   example, two game controllers from the same vendor with the same
- *   product ID and revision may have the same GUID.
+ * If the device is detached and then re-attached to a different port, or if
+ * the base system is rebooted, the device should still report the same GUID.
 *
- * GUIDs may be platform-dependent (i.e., the same device may report
- *   different GUIDs on different operating systems).
+ * GUIDs are as precise as possible but are not guaranteed to distinguish
+ * physically distinct but equivalent devices. For example, two game
+ * controllers from the same vendor with the same product ID and revision may
+ * have the same GUID.
+ *
+ * GUIDs may be platform-dependent (i.e., the same device may report different
+ * GUIDs on different operating systems).
 */
 typedef struct SDL_GUID {
    Uint8 data[16];
@@ -72,13 +72,13 @@ extern "C" {
 #endif

 /**
- *  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 */

 /**
- *  HID underlying bus types.
+ * HID underlying bus types.
 */
 typedef enum SDL_hid_bus_type {
    /** Unknown bus type */
@@ -109,8 +109,9 @@ typedef enum SDL_hid_bus_type {
 } SDL_hid_bus_type;

 /** hidapi info structure */
+
 /**
- *  Information about a connected HID device
+ * Information about a connected HID device
 */
 typedef struct SDL_hid_device_info
 {
@@ -40,10 +40,10 @@ extern "C" {
 /* As of version 0.5, SDL is loaded dynamically into the application */

 /**
- *   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.
+ * These are the flags which may be passed to SDL_Init(). You should specify
+ * the subsystems which you will be using in your application.
 *
 * \sa SDL_Init
 * \sa SDL_Quit
@@ -56,11 +56,10 @@ typedef enum SDL_IOStatus
 /**
 * The function pointers that drive an SDL_IOStream.
 *
- * Applications can provide this struct to SDL_OpenIO() to
- * create their own implementation of SDL_IOStream. This is
- * not necessarily required, as SDL already offers several
- * common types of I/O streams, via functions like SDL_IOFromFile()
- * and SDL_IOFromMem().
+ * Applications can provide this struct to SDL_OpenIO() to create their own
+ * implementation of SDL_IOStream. This is not necessarily required, as SDL
+ * already offers several common types of I/O streams, via functions like
+ * SDL_IOFromFile() and SDL_IOFromMem().
 *
 * \since This struct is available since SDL 3.0.0.
 */
@@ -120,10 +119,10 @@ typedef struct SDL_IOStreamInterface
 /**
 * The read/write operation structure.
 *
- * This operates as an opaque handle. There are several APIs to create
- * various types of I/O streams, or an app can supply an
- * SDL_IOStreamInterface to SDL_OpenIO() to provide their own stream
- * implementation behind this struct's abstract interface.
+ * This operates as an opaque handle. There are several APIs to create various
+ * types of I/O streams, or an app can supply an SDL_IOStreamInterface to
+ * SDL_OpenIO() to provide their own stream implementation behind this
+ * struct's abstract interface.
 *
 * \since This struct is available since SDL 3.0.0.
 */
@@ -323,8 +322,8 @@ extern DECLSPEC SDL_IOStream *SDLCALL SDL_IOFromDynamicMem(void);
 *
 * You must free the returned pointer with SDL_CloseIO().
 *
- * This function makes a copy of `iface` and the caller does not need to
- * keep this data around after this call.
+ * This function makes a copy of `iface` and the caller does not need to keep
+ * this data around after this call.
 *
 * \param iface The function pointers that implement this SDL_IOStream.
 * \param userdata The app-controlled pointer that is passed to iface's
@@ -356,8 +356,10 @@ extern DECLSPEC SDL_JoystickID SDLCALL SDL_AttachVirtualJoystick(SDL_JoystickTyp
 /**
 * The structure that defines an extended virtual joystick description
 *
- * The caller must zero the structure and then initialize the version with `SDL_VIRTUAL_JOYSTICK_DESC_VERSION` before passing it to SDL_AttachVirtualJoystickEx()
- *  All other elements of this structure are optional and can be left 0.
+ * The caller must zero the structure and then initialize the version with
+ * `SDL_VIRTUAL_JOYSTICK_DESC_VERSION` before passing it to
+ * SDL_AttachVirtualJoystickEx() All other elements of this structure are
+ * optional and can be left 0.
 *
 * \sa SDL_AttachVirtualJoystickEx
 */
@@ -42,9 +42,10 @@ extern "C" {
 typedef Uint32 SDL_KeyboardID;

 /**
- *  The SDL keysym structure, used in key events.
+ * The SDL keysym structure, used in key events.
 *
- *  If you are looking for translated character input, see the ::SDL_EVENT_TEXT_INPUT event.
+ * If you are looking for translated character input, see the
+ * ::SDL_EVENT_TEXT_INPUT event.
 */
 typedef struct SDL_Keysym
 {
@@ -42,10 +42,10 @@ extern "C" {
 /**
 * A struct to provide locale data.
 *
- * Locale data is split into a spoken language, like English, and an
- * optional country, like Canada. The language will be in ISO-639 format
- * (so English would be "en"), and the country, if not NULL, will be an
- * ISO-3166 country code (so Canada would be "CA").
+ * Locale data is split into a spoken language, like English, and an optional
+ * country, like Canada. The language will be in ISO-639 format (so English
+ * would be "en"), and the country, if not NULL, will be an ISO-3166 country
+ * code (so Canada would be "CA").
 *
 * \since This function is available since SDL 3.0.0.
 *
@@ -47,19 +47,18 @@ extern "C" {


 /**
- *  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.
+ * As of 2.0.24 there is no limit to the length of SDL log messages.
 */
 #define SDL_MAX_LOG_MESSAGE 4096

 /**
- *  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
- *  at the VERBOSE level and all other categories are enabled at the
- *  ERROR level.
+ * By default the application category is enabled at the INFO level, the
+ * assert category is enabled at the WARN level, test is enabled at the
+ * VERBOSE level and all other categories are enabled at the ERROR level.
 */
 typedef enum SDL_LogCategory
 {
@@ -97,7 +96,7 @@ typedef enum SDL_LogCategory
 } SDL_LogCategory;

 /**
- *  The predefined log priorities
+ * The predefined log priorities
 */
 typedef enum SDL_LogPriority
 {
@@ -33,7 +33,9 @@ extern "C" {
 #endif

 /**
- * SDL_MessageBox flags. If supported will display warning icon, etc.
+ * SDL_MessageBox flags.
+ *
+ * If supported will display warning icon, etc.
 */
 typedef enum SDL_MessageBoxFlags
 {
@@ -509,9 +509,9 @@ extern DECLSPEC SDL_bool SDLCALL SDL_CursorVisible(void);
 /**
 * Used as a mask when testing buttons in buttonstate.
 *
- * - Button 1:  Left mouse button
- * - Button 2:  Middle mouse button
- * - Button 3:  Right mouse button
+ * - Button 1: Left mouse button
+ * - Button 2: Middle mouse button
+ * - Button 3: Right mouse button
 */
 #define SDL_BUTTON(X)       (1 << ((X)-1))
 #define SDL_BUTTON_LEFT     1
@@ -116,8 +116,8 @@ extern "C" {
 #endif

 /**
- *  Synchronization functions which can time out return this value
- *  if they time out.
+ * Synchronization functions which can time out return this value if they time
+ * out.
 */
 #define SDL_MUTEX_TIMEDOUT  1

@@ -66,11 +66,12 @@ typedef Uint32 SDL_PenID; /**< SDL_PenIDs identify pens uniquely within a sessio
 /**
 * Pen axis indices
 *
- * Below are the valid indices to the "axis" array from SDL_PenMotionEvent and SDL_PenButtonEvent.
- * The axis indices form a contiguous range of ints from 0 to SDL_PEN_AXIS_LAST, inclusive.
- * All "axis[]" entries are either normalised to  0..1 or report a (positive or negative)
- * angle in degrees, with 0.0 representing the centre.
- * Not all pens/backends support all axes: unsupported entries are always "0.0f".
+ * Below are the valid indices to the "axis" array from SDL_PenMotionEvent and
+ * SDL_PenButtonEvent. The axis indices form a contiguous range of ints from 0
+ * to SDL_PEN_AXIS_LAST, inclusive. All "axis[]" entries are either normalised
+ * to 0..1 or report a (positive or negative) angle in degrees, with 0.0
+ * representing the centre. Not all pens/backends support all axes:
+ * unsupported entries are always "0.0f".
 *
 * To convert angles for tilt and rotation into vector representation, use
 * SDL_sinf on the XTILT, YTILT, or ROTATION component, for example:
@@ -122,7 +123,8 @@ typedef enum SDL_PenAxis
 /**
 * Pen types
 *
- * Some pens identify as a particular type of drawing device (e.g., an airbrush or a pencil).
+ * Some pens identify as a particular type of drawing device (e.g., an
+ * airbrush or a pencil).
 *
 * \since This enum is available since SDL 3.0.0
 */
@@ -221,10 +223,10 @@ extern DECLSPEC SDL_bool SDLCALL SDL_PenConnected(SDL_PenID instance_id);
 * \returns A string that contains the name of the pen, intended for human
 *          consumption. The string might or might not be localised, depending
 *          on platform settings. It is not guaranteed to be unique; use
- *          SDL_GetPenGUID() for (best-effort) unique identifiers. The
- *          pointer is managed by the SDL pen subsystem and must not be
- *          deallocated. The pointer remains valid until SDL is shut down.
- *          Returns NULL on error (cf. SDL_GetError())
+ *          SDL_GetPenGUID() for (best-effort) unique identifiers. The pointer
+ *          is managed by the SDL pen subsystem and must not be deallocated.
+ *          The pointer remains valid until SDL is shut down. Returns NULL on
+ *          error (cf. SDL_GetError())
 *
 * \since This function is available since SDL 3.0.0
 */
@@ -258,10 +260,10 @@ extern DECLSPEC Uint32 SDLCALL SDL_GetPenCapabilities(SDL_PenID instance_id, SDL
 * \param instance_id The pen to query.
 * \returns The corresponding pen type (cf. SDL_PenSubtype) or 0 on error.
 *          Note that the pen type does not dictate whether the pen tip is
- *          SDL_PEN_TIP_INK or SDL_PEN_TIP_ERASER; to determine whether a
- *          pen is being used for drawing or in eraser mode, check either the
- *          pen tip on SDL_EVENT_PEN_DOWN, or the flag SDL_PEN_ERASER_MASK
- *          in the pen state.
+ *          SDL_PEN_TIP_INK or SDL_PEN_TIP_ERASER; to determine whether a pen
+ *          is being used for drawing or in eraser mode, check either the pen
+ *          tip on SDL_EVENT_PEN_DOWN, or the flag SDL_PEN_ERASER_MASK in the
+ *          pen state.
 *
 * \since This function is available since SDL 3.0.0
 */
@@ -457,7 +457,8 @@ typedef enum SDL_ColorType
 } SDL_ColorType;

 /**
- * The color range, as described by https://www.itu.int/rec/R-REC-BT.2100-2-201807-I/en
+ * The color range, as described by
+ * https://www.itu.int/rec/R-REC-BT.2100-2-201807-I/en
 */
 typedef enum SDL_ColorRange
 {
@@ -467,7 +468,8 @@ typedef enum SDL_ColorRange
 } SDL_ColorRange;

 /**
- * The color primaries, as described by https://www.itu.int/rec/T-REC-H.273-201612-S/en
+ * The color primaries, as described by
+ * https://www.itu.int/rec/T-REC-H.273-201612-S/en
 */
 typedef enum SDL_ColorPrimaries
 {
@@ -488,7 +490,8 @@ typedef enum SDL_ColorPrimaries
 } SDL_ColorPrimaries;

 /**
- * The transfer characteristics, as described by https://www.itu.int/rec/T-REC-H.273-201612-S/en
+ * The transfer characteristics, as described by
+ * https://www.itu.int/rec/T-REC-H.273-201612-S/en
 */
 typedef enum SDL_TransferCharacteristics
 {
@@ -514,7 +517,8 @@ typedef enum SDL_TransferCharacteristics
 } SDL_TransferCharacteristics;

 /**
- * The matrix coefficients, as described by https://www.itu.int/rec/T-REC-H.273-201612-S/en
+ * The matrix coefficients, as described by
+ * https://www.itu.int/rec/T-REC-H.273-201612-S/en
 */
 typedef enum SDL_MatrixCoefficients
 {
@@ -663,9 +667,10 @@ typedef enum SDL_Colorspace
 /**
 * A structure that represents a color as RGBA components.
 *
- * The bits of this structure can be directly reinterpreted as an integer-packed
- * color which uses the SDL_PIXELFORMAT_RGBA32 format (SDL_PIXELFORMAT_ABGR8888
- * on little-endian systems and SDL_PIXELFORMAT_RGBA8888 on big-endian systems).
+ * The bits of this structure can be directly reinterpreted as an
+ * integer-packed color which uses the SDL_PIXELFORMAT_RGBA32 format
+ * (SDL_PIXELFORMAT_ABGR8888 on little-endian systems and
+ * SDL_PIXELFORMAT_RGBA8888 on big-endian systems).
 *
 * \since This struct is available since SDL 3.0.0.
 */
@@ -712,9 +717,8 @@ typedef struct SDL_Palette
 /**
 * Details about the format of a pixel.
 *
- * Generally this is used with SDL_Surface, and covers many
- * possible configurations, including paletted data and various
- * bit patterns.
+ * Generally this is used with SDL_Surface, and covers many possible
+ * configurations, including paletted data and various bit patterns.
 *
 * \since This struct is available since SDL 3.0.0.
 */
@@ -40,10 +40,10 @@ extern "C" {
 /**
 * The structure that defines a point (using integers).
 *
+ * \since This struct is available since SDL 3.0.0.
+ *
 * \sa SDL_GetRectEnclosingPoints
 * \sa SDL_PointInRect
- *
- * \since This struct is available since SDL 3.0.0.
 */
 typedef struct SDL_Point
 {
@@ -54,10 +54,10 @@ typedef struct SDL_Point
 /**
 * The structure that defines a point (using floating point values).
 *
+ * \since This struct is available since SDL 3.0.0.
+ *
 * \sa SDL_GetRectEnclosingPointsFloat
 * \sa SDL_PointInRectFloat
- *
- * \since This struct is available since SDL 3.0.0.
 */
 typedef struct SDL_FPoint
 {
@@ -69,6 +69,8 @@ typedef struct SDL_FPoint
 /**
 * A rectangle, with the origin at the upper left (using integers).
 *
+ * \since This struct is available since SDL 3.0.0.
+ *
 * \sa SDL_RectEmpty
 * \sa SDL_RectsEqual
 * \sa SDL_HasRectIntersection
@@ -76,8 +78,6 @@ typedef struct SDL_FPoint
 * \sa SDL_GetRectAndLineIntersection
 * \sa SDL_GetRectUnion
 * \sa SDL_GetRectEnclosingPoints
- *
- * \since This struct is available since SDL 3.0.0.
 */
 typedef struct SDL_Rect
 {
@@ -87,7 +87,10 @@ typedef struct SDL_Rect


 /**
- * A rectangle, with the origin at the upper left (using floating point values).
+ * A rectangle, with the origin at the upper left (using floating point
+ * values).
+ *
+ * \since This struct is available since SDL 3.0.0.
 *
 * \sa SDL_RectEmptyFloat
 * \sa SDL_RectsEqualFloat
@@ -98,8 +101,6 @@ typedef struct SDL_Rect
 * \sa SDL_GetRectUnionFloat
 * \sa SDL_GetRectEnclosingPointsFloat
 * \sa SDL_PointInRectFloat
- *
- * \since This struct is available since SDL 3.0.0.
 */
 typedef struct SDL_FRect
 {
@@ -88,7 +88,7 @@ typedef struct SDL_RendererInfo
 } SDL_RendererInfo;

 /**
- *  Vertex structure.
+ * Vertex structure.
 */
 typedef struct SDL_Vertex
 {
@@ -81,16 +81,16 @@ typedef enum
 /**
 * Accelerometer sensor.
 *
- * The accelerometer returns the current acceleration in SI meters per
- * second squared. This measurement includes the force of gravity, so
- * a device at rest will have an value of SDL_STANDARD_GRAVITY away
- * from the center of the earth, which is a positive Y value.
+ * The accelerometer returns the current acceleration in SI meters per second
+ * squared. This measurement includes the force of gravity, so a device at
+ * rest will have an value of SDL_STANDARD_GRAVITY away from the center of the
+ * earth, which is a positive Y value.
 *
- * values[0]: Acceleration on the x axis
- * values[1]: Acceleration on the y axis
+ * values[0]: Acceleration on the x axis values[1]: Acceleration on the y axis
 * values[2]: Acceleration on the z axis
 *
- * For phones and tablets held in natural orientation and game controllers held in front of you, the axes are defined as follows:
+ * For phones and tablets held in natural orientation and game controllers
+ * held in front of you, the axes are defined as follows:
 *
 * - -X ... +X : left ... right
 * - -Y ... +Y : bottom ... top
@@ -98,7 +98,7 @@ typedef enum
 *
 * The axis data is not changed when the device is rotated.
 *
- * \sa SDL_GetCurrentDisplayOrientation()
+ * \sa SDL_GetCurrentDisplayOrientation
 */
 #define SDL_STANDARD_GRAVITY    9.80665f

@@ -87,15 +87,15 @@ char *alloca();
 #endif

 /**
- *  The number of elements in an array.
+ * The number of elements in an array.
 */
 #define SDL_arraysize(array)    (sizeof(array)/sizeof(array[0]))
 #define SDL_TABLESIZE(table)    SDL_arraysize(table)

 /**
- *  Macro useful for building other macros with strings in them.
+ * Macro useful for building other macros with strings in them.
 *
- *  For example:
+ * For example:
 *
 * ```c
 * #define LOG_ERROR(X) OutputDebugString(SDL_STRINGIFY_ARG(__FUNCTION__) ": " X "\n")`
@@ -146,30 +146,35 @@ typedef int SDL_bool;
 #define SDL_MAX_SINT8   ((Sint8)0x7F)           /* 127 */
 #define SDL_MIN_SINT8   ((Sint8)(~0x7F))        /* -128 */
 typedef int8_t Sint8;
+
 /**
 * An unsigned 8-bit integer type.
 */
 #define SDL_MAX_UINT8   ((Uint8)0xFF)           /* 255 */
 #define SDL_MIN_UINT8   ((Uint8)0x00)           /* 0 */
 typedef uint8_t Uint8;
+
 /**
 * A signed 16-bit integer type.
 */
 #define SDL_MAX_SINT16  ((Sint16)0x7FFF)        /* 32767 */
 #define SDL_MIN_SINT16  ((Sint16)(~0x7FFF))     /* -32768 */
 typedef int16_t Sint16;
+
 /**
 * An unsigned 16-bit integer type.
 */
 #define SDL_MAX_UINT16  ((Uint16)0xFFFF)        /* 65535 */
 #define SDL_MIN_UINT16  ((Uint16)0x0000)        /* 0 */
 typedef uint16_t Uint16;
+
 /**
 * A signed 32-bit integer type.
 */
 #define SDL_MAX_SINT32  ((Sint32)0x7FFFFFFF)    /* 2147483647 */
 #define SDL_MIN_SINT32  ((Sint32)(~0x7FFFFFFF)) /* -2147483648 */
 typedef int32_t Sint32;
+
 /**
 * An unsigned 32-bit integer type.
 */
@@ -183,6 +188,7 @@ typedef uint32_t Uint32;
 #define SDL_MAX_SINT64  ((Sint64)0x7FFFFFFFFFFFFFFFll)      /* 9223372036854775807 */
 #define SDL_MIN_SINT64  ((Sint64)(~0x7FFFFFFFFFFFFFFFll))   /* -9223372036854775808 */
 typedef int64_t Sint64;
+
 /**
 * An unsigned 64-bit integer type.
 */
@@ -191,10 +197,12 @@ typedef int64_t Sint64;
 typedef uint64_t Uint64;

 /**
- * SDL times are signed, 64-bit integers representing nanoseconds since the Unix epoch (Jan 1, 1970).
+ * SDL times are signed, 64-bit integers representing nanoseconds since the
+ * Unix epoch (Jan 1, 1970).
 *
- * They can be converted between POSIX time_t values with SDL_NS_TO_SECONDS() and SDL_SECONDS_TO_NS(),
- * and between Windows FILETIME values with SDL_TimeToWindows() and SDL_TimeFromWindows().
+ * They can be converted between POSIX time_t values with SDL_NS_TO_SECONDS()
+ * and SDL_SECONDS_TO_NS(), and between Windows FILETIME values with
+ * SDL_TimeToWindows() and SDL_TimeFromWindows().
 */
 #define SDL_MAX_TIME SDL_MAX_SINT64
 #define SDL_MIN_TIME SDL_MIN_SINT64
@@ -60,7 +60,7 @@ extern "C" {
 /* @} *//* Surface flags */

 /**
- *  Evaluates to true if the surface needs to be locked before access.
+ * Evaluates to true if the surface needs to be locked before access.
 */
 #define SDL_MUSTLOCK(S) (((S)->flags & SDL_RLEACCEL) != 0)

@@ -89,21 +89,17 @@ typedef enum SDL_FlipMode
 /**
 * 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
- * known as the row stride in non-SDL APIs).
+ * Pixels are arranged in memory in rows, with the top row first. Each row
+ * occupies an amount of memory given by the pitch (sometimes known as the row
+ * stride in non-SDL APIs).
 *
- * Within each row, pixels are arranged from left to right until the
- * width is reached.
- * Each pixel occupies a number of bits appropriate for its format, with
- * most formats representing each pixel as one or more whole bytes
- * (in some indexed formats, instead multiple pixels are packed into
- * each byte), and a byte order given by the format.
- * After encoding all pixels, any remaining bytes to reach the pitch are
- * used as padding to reach a desired alignment, and have undefined contents.
- *
- * \note  This structure should be treated as read-only, except for \c pixels,
- *        which, if not NULL, contains the raw pixel data for the surface.
+ * Within each row, pixels are arranged from left to right until the width is
+ * reached. Each pixel occupies a number of bits appropriate for its format,
+ * with most formats representing each pixel as one or more whole bytes (in
+ * some indexed formats, instead multiple pixels are packed into each byte),
+ * and a byte order given by the format. After encoding all pixels, any
+ * remaining bytes to reach the pitch are used as padding to reach a desired
+ * alignment, and have undefined contents.
 */
 typedef struct SDL_Surface
 {
@@ -337,9 +337,9 @@ extern DECLSPEC SDL_bool SDLCALL SDL_IsDeXMode(void);
 extern DECLSPEC void SDLCALL SDL_AndroidBackButton(void);

 /**
-   See the official Android developer guide for more information:
-   http://developer.android.com/guide/topics/data/data-storage.html
-*/
+ * See the official Android developer guide for more information:
+ * http://developer.android.com/guide/topics/data/data-storage.html
+ */
 #define SDL_ANDROID_EXTERNAL_STORAGE_READ   0x01
 #define SDL_ANDROID_EXTERNAL_STORAGE_WRITE  0x02

@@ -479,7 +479,7 @@ extern DECLSPEC int SDLCALL SDL_AndroidSendMessage(Uint32 command, int param);
 #ifdef SDL_PLATFORM_WINRT

 /**
- *  WinRT / Windows Phone path types
+ * WinRT / Windows Phone path types
 */
 typedef enum SDL_WinRT_Path
 {
@@ -503,7 +503,7 @@ typedef enum SDL_WinRT_Path


 /**
- *  WinRT Device Family
+ * WinRT Device Family
 */
 typedef enum SDL_WinRT_DeviceFamily
 {
@@ -56,14 +56,13 @@ typedef Uint64 SDL_ThreadID;
 typedef Uint32 SDL_TLSID;

 /**
- *  The SDL thread priority.
+ * The SDL thread priority.
 *
- *  SDL will make system changes as necessary in order to apply the thread priority.
- *  Code which attempts to control thread state related to priority should be aware
- *  that calling SDL_SetThreadPriority may alter such state.
- *  SDL_HINT_THREAD_PRIORITY_POLICY can be used to control aspects of this behavior.
- *
- *  \note On many systems you require special privileges to set high or time critical priority.
+ * SDL will make system changes as necessary in order to apply the thread
+ * priority. Code which attempts to control thread state related to priority
+ * should be aware that calling SDL_SetThreadPriority may alter such state.
+ * SDL_HINT_THREAD_PRIORITY_POLICY can be used to control aspects of this
+ * behavior.
 */
 typedef enum SDL_ThreadPriority {
    SDL_THREAD_PRIORITY_LOW,
@@ -38,7 +38,8 @@ extern "C" {
 #endif

 /**
- * A structure holding a calendar date and time broken down into its components.
+ * A structure holding a calendar date and time broken down into its
+ * components.
 */
 typedef struct SDL_DateTime
 {
@@ -41,15 +41,14 @@ extern "C" {
 * Information about the version of SDL in use.
 *
 * Represents the library's version as three levels: major revision
- * (increments with massive changes, additions, and enhancements),
- * minor revision (increments with backwards-compatible changes to the
- * major revision), and patchlevel (increments with fixes to the minor
- * revision).
+ * (increments with massive changes, additions, and enhancements), minor
+ * revision (increments with backwards-compatible changes to the major
+ * revision), and patchlevel (increments with fixes to the minor revision).
+ *
+ * \since This struct is available since SDL 3.0.0.
 *
 * \sa SDL_VERSION
 * \sa SDL_GetVersion
- *
- * \since This struct is available since SDL 3.0.0.
 */
 typedef struct SDL_Version
 {
@@ -70,15 +69,15 @@ typedef struct SDL_Version
 * library you compiled against. This is determined by what header the
 * compiler uses. Note that if you dynamically linked the library, you might
 * have a slightly newer or older version at runtime. That version can be
- * determined with SDL_GetVersion(), which, unlike SDL_VERSION(),
- * is not a macro.
+ * determined with SDL_GetVersion(), which, unlike SDL_VERSION(), is not a
+ * macro.
 *
 * \param x A pointer to an SDL_Version struct to initialize.
 *
+ * \since This macro is available since SDL 3.0.0.
+ *
 * \sa SDL_Version
 * \sa SDL_GetVersion
- *
- * \since This macro is available since SDL 3.0.0.
 */
 #define SDL_VERSION(x)                \
 {                                     \
@@ -102,7 +101,7 @@ typedef struct SDL_Version
    ((major) << 24 | (minor) << 8 | (patch) << 0)

 /**
- *  This is the version number macro for the current SDL version.
+ * This is the version number macro for the current SDL version.
 *
 * \since This macro is available since SDL 3.0.0.
 */
@@ -110,7 +109,7 @@ typedef struct SDL_Version
    SDL_VERSIONNUM(SDL_MAJOR_VERSION, SDL_MINOR_VERSION, SDL_PATCHLEVEL)

 /**
- *  This macro will evaluate to true if compiled with SDL at least X.Y.Z.
+ * This macro will evaluate to true if compiled with SDL at least X.Y.Z.
 *
 * \since This macro is available since SDL 3.0.0.
 */
@@ -76,13 +76,13 @@ typedef enum SDL_SystemTheme
 /**
 * The structure that defines a display mode.
 *
- * \sa SDL_GetFullscreenDisplayModes()
- * \sa SDL_GetDesktopDisplayMode()
- * \sa SDL_GetCurrentDisplayMode()
- * \sa SDL_SetWindowFullscreenMode()
- * \sa SDL_GetWindowFullscreenMode()
- *
 * \since This struct is available since SDL 3.0.0.
+ *
+ * \sa SDL_GetFullscreenDisplayModes
+ * \sa SDL_GetDesktopDisplayMode
+ * \sa SDL_GetCurrentDisplayMode
+ * \sa SDL_SetWindowFullscreenMode
+ * \sa SDL_GetWindowFullscreenMode
 */
 typedef struct SDL_DisplayMode
 {
@@ -110,7 +110,7 @@ typedef enum SDL_DisplayOrientation
 } SDL_DisplayOrientation;

 /**
- *  The struct used as an opaque handle to a window.
+ * The struct used as an opaque handle to a window.
 *
 * \since This struct is available since SDL 3.0.0.
 *
@@ -155,7 +155,7 @@ typedef Uint32 SDL_WindowFlags;
 #define SDL_WINDOW_NOT_FOCUSABLE        0x80000000U /**< window should not be focusable */

 /**
- *  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 Uint32 SDL_WindowFlags;
            (((X)&0xFFFF0000) == SDL_WINDOWPOS_UNDEFINED_MASK)

 /**
- *  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))
@@ -207,9 +207,17 @@ typedef SDL_EGLint *(SDLCALL *SDL_EGLIntArrayCallback)(void);
 /**
 * An enumeration of OpenGL configuration attributes.
 *
- * While you can set most OpenGL attributes normally, the attributes listed above must be known before SDL creates the window that will be used with the OpenGL context. These attributes are set and read with SDL_GL_SetAttribute() and SDL_GL_GetAttribute().
+ * While you can set most OpenGL attributes normally, the attributes listed
+ * above must be known before SDL creates the window that will be used with
+ * the OpenGL context. These attributes are set and read with
+ * SDL_GL_SetAttribute() and SDL_GL_GetAttribute().
 *
- * In some cases, these attributes are minimum requests; the GL does not promise to give you exactly what you asked for. It's possible to ask for a 16-bit depth buffer and get a 24-bit one instead, for example, or to ask for no stencil buffer and still have one available. Context creation should fail if the GL can't provide your requested attributes at a minimum, but you should check to see exactly what you got.
+ * In some cases, these attributes are minimum requests; the GL does not
+ * promise to give you exactly what you asked for. It's possible to ask for a
+ * 16-bit depth buffer and get a 24-bit one instead, for example, or to ask
+ * for no stencil buffer and still have one available. Context creation should
+ * fail if the GL can't provide your requested attributes at a minimum, but
+ * you should check to see exactly what you got.
 *
 * \since This enum is available since SDL 3.0.0.
 */
@@ -271,7 +279,8 @@ typedef enum SDL_GLcontextFlag
 } SDL_GLcontextFlag;

 /**
- * Possible values to be set for the SDL_GL_CONTEXT_RELEASE_BEHAVIOR attribute.
+ * Possible values to be set for the SDL_GL_CONTEXT_RELEASE_BEHAVIOR
+ * attribute.
 *
 * \since This enum is available since SDL 3.0.0.
 */