SDL: surface: Make a typedef for SDL_Surface bitflags, as is SDL3 policy.

From 241cfaf38f0cc71bd3bb894212a5157943f217e2 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Thu, 16 May 2024 12:29:58 -0400
Subject: [PATCH] surface: Make a typedef for SDL_Surface bitflags, as is SDL3
 policy.

Reference Issue #9812.
---
 include/SDL3/SDL_surface.h | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/include/SDL3/SDL_surface.h b/include/SDL3/SDL_surface.h
index a03e488454a55..327f4285ab0fd 100644
--- a/include/SDL3/SDL_surface.h
+++ b/include/SDL3/SDL_surface.h
@@ -43,21 +43,20 @@ extern "C" {
 #endif
 
 /**
- *  \name Surface flags
+ * The flags on an SDL_Surface.
  *
- *  These are the currently supported flags for an SDL_Surface.
+ * These are generally meant to be considered read-only.
  *
- *  \internal
- *  Used internally (read-only).
+ * \since This datatype is available since SDL 3.0.0.
  */
-/* @{ */
+typedef Uint32 SDL_SurfaceFlags;
+
 #define SDL_SWSURFACE               0           /**< Just here for compatibility */
 #define SDL_PREALLOC                0x00000001  /**< Surface uses preallocated memory */
 #define SDL_RLEACCEL                0x00000002  /**< Surface is RLE encoded */
 #define SDL_DONTFREE                0x00000004  /**< Surface is referenced internally */
 #define SDL_SIMD_ALIGNED            0x00000008  /**< Surface uses aligned memory */
 #define SDL_SURFACE_USES_PROPERTIES 0x00000010  /**< Surface uses properties */
-/* @} *//* Surface flags */
 
 /**
  * Evaluates to true if the surface needs to be locked before access.
@@ -119,7 +118,7 @@ typedef enum SDL_FlipMode
  */
 typedef struct SDL_Surface
 {
-    Uint32 flags;               /**< Read-only */
+    SDL_SurfaceFlags flags;     /**< Read-only */
     SDL_PixelFormat *format;    /**< Read-only */
     int w, h;                   /**< Read-only */
     int pitch;                  /**< Read-only */