From ac372e99fe4fbc46f95029ee303a4283c41e1675 Mon Sep 17 00:00:00 2001
From: SDL Wiki Bot <icculus-sdlwikibot@icculus.org>
Date: Thu, 4 Apr 2024 13:41:27 +0000
Subject: [PATCH] Sync SDL3 wiki -> header

---
 include/SDL3/SDL_filesystem.h | 14 ++++++++------
 include/SDL3/SDL_storage.h    | 15 +++++++++------
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/include/SDL3/SDL_filesystem.h b/include/SDL3/SDL_filesystem.h
index 851ea9bd4..4cdde117e 100644
--- a/include/SDL3/SDL_filesystem.h
+++ b/include/SDL3/SDL_filesystem.h
@@ -275,8 +275,8 @@ typedef int (SDLCALL *SDL_EnumerateDirectoryCallback)(void *userdata, const char
  * Enumerate a directory through a callback function.
  *
  * This function provides every directory entry through an app-provided
- * callback, called once for each directory entry, until all results have
- * been provided or the callback returns <= 0.
+ * callback, called once for each directory entry, until all results have been
+ * provided or the callback returns <= 0.
  *
  * \param path the path of the directory to enumerate
  * \param callback a function that is called for each entry in the directory
@@ -347,16 +347,18 @@ extern DECLSPEC int SDLCALL SDL_GetPathInfo(const char *path, SDL_PathInfo *info
  * You must free the returned pointer with SDL_free() when done with it.
  *
  * \param path the path of the directory to enumerate
- * \param pattern the pattern that files in the directory must match. Can be NULL.
+ * \param pattern the pattern that files in the directory must match. Can be
+ *                NULL.
  * \param flags `SDL_GLOBDIR_*` bitflags that affect this search.
- * \param count on return, will be set to the number of items in the returned array. Can be NULL.
+ * \param count on return, will be set to the number of items in the returned
+ *              array. Can be NULL.
  * \returns an array of strings on success or NULL on failure; call
  *          SDL_GetError() for more information. The caller should pass the
  *          returned pointer to SDL_free when done with it.
  *
- * \since This function is available since SDL 3.0.0.
- *
  * \threadsafety It is safe to call this function from any thread.
+ *
+ * \since This function is available since SDL 3.0.0.
  */
 extern DECLSPEC char **SDLCALL SDL_GlobDirectory(const char *path, const char *pattern, Uint32 flags, int *count);
 
diff --git a/include/SDL3/SDL_storage.h b/include/SDL3/SDL_storage.h
index 4abc08bc4..d91759221 100644
--- a/include/SDL3/SDL_storage.h
+++ b/include/SDL3/SDL_storage.h
@@ -271,8 +271,8 @@ extern DECLSPEC int SDLCALL SDL_CreateStorageDirectory(SDL_Storage *storage, con
  * Enumerate a directory in a storage container through a callback function.
  *
  * This function provides every directory entry through an app-provided
- * callback, called once for each directory entry, until all results have
- * been provided or the callback returns <= 0.
+ * callback, called once for each directory entry, until all results have been
+ * provided or the callback returns <= 0.
  *
  * \param storage a storage container
  * \param path the path of the directory to enumerate
@@ -366,16 +366,19 @@ extern DECLSPEC Uint64 SDLCALL SDL_GetStorageSpaceRemaining(SDL_Storage *storage
  *
  * \param storage a storage container
  * \param path the path of the directory to enumerate
- * \param pattern the pattern that files in the directory must match. Can be NULL.
+ * \param pattern the pattern that files in the directory must match. Can be
+ *                NULL.
  * \param flags `SDL_GLOBDIR_*` bitflags that affect this search.
- * \param count on return, will be set to the number of items in the returned array. Can be NULL.
+ * \param count on return, will be set to the number of items in the returned
+ *              array. Can be NULL.
  * \returns an array of strings on success or NULL on failure; call
  *          SDL_GetError() for more information. The caller should pass the
  *          returned pointer to SDL_free when done with it.
  *
- * \since This function is available since SDL 3.0.0.
+ * \threadsafety It is safe to call this function from any thread, assuming
+ *               the `storage` object is thread-safe.
  *
- * \threadsafety It is safe to call this function from any thread, assuming the `storage` object is thread-safe.
+ * \since This function is available since SDL 3.0.0.
  */
 extern DECLSPEC char **SDLCALL SDL_GlobStorageDirectory(SDL_Storage *storage, const char *path, const char *pattern, Uint32 flags, int *count);