SDL: Fix comments

From 627165a2b226a3d510933406de2db9b61210a7e9 Mon Sep 17 00:00:00 2001
From: Sylvain <[EMAIL REDACTED]>
Date: Thu, 22 Jun 2023 15:42:51 +0200
Subject: [PATCH] Fix comments

---
 include/SDL3/SDL_audio.h      | 1 +
 include/SDL3/SDL_clipboard.h  | 1 +
 include/SDL3/SDL_filesystem.h | 3 +++
 include/SDL3/SDL_hidapi.h     | 4 ++++
 include/SDL3/SDL_video.h      | 2 ++
 5 files changed, 11 insertions(+)

diff --git a/include/SDL3/SDL_audio.h b/include/SDL3/SDL_audio.h
index 544bd98fefe9..b36ceb1b213f 100644
--- a/include/SDL3/SDL_audio.h
+++ b/include/SDL3/SDL_audio.h
@@ -758,6 +758,7 @@ extern DECLSPEC int SDLCALL SDL_GetAudioStreamFormat(SDL_AudioStream *stream,
  * will reflect the new format, and future calls to SDL_PutAudioStreamData
  * must provide data in the new input formats.
  *
+ * \param stream The stream the format is being changed
  * \param src_format The format of the audio input
  * \param src_channels The number of channels of the audio input
  * \param src_rate The sampling rate of the audio input
diff --git a/include/SDL3/SDL_clipboard.h b/include/SDL3/SDL_clipboard.h
index a1d56c75a487..4e223a57ac9f 100644
--- a/include/SDL3/SDL_clipboard.h
+++ b/include/SDL3/SDL_clipboard.h
@@ -195,6 +195,7 @@ extern DECLSPEC void *SDLCALL SDL_GetClipboardUserdata(void);
 /**
  * Get the data from clipboard for a given mime type
  *
+ * \param length Length of the data
  * \param mime_type The mime type to read from the clipboard
  * \returns the retrieved data buffer or NULL on failure; call SDL_GetError()
  *          for more information. Caller must call SDL_free() on the returned
diff --git a/include/SDL3/SDL_filesystem.h b/include/SDL3/SDL_filesystem.h
index 91e710b8d39b..69788b2e2434 100644
--- a/include/SDL3/SDL_filesystem.h
+++ b/include/SDL3/SDL_filesystem.h
@@ -221,9 +221,12 @@ typedef enum
  *
  * If NULL is returned, the error may be obtained with SDL_GetError().
  *
+ * \param folder The type of folder to find
  * \returns Either a null-terminated C string containing the full path to the
  *          folder, or NULL if an error happened.
  *
+ * \since This function is available since SDL 3.0.0.
+ *
  * \sa SDL_Folder
  */
 extern DECLSPEC char *SDLCALL SDL_GetPath(SDL_Folder folder);
diff --git a/include/SDL3/SDL_hidapi.h b/include/SDL3/SDL_hidapi.h
index 6b6e0f661354..17825c7787dd 100644
--- a/include/SDL3/SDL_hidapi.h
+++ b/include/SDL3/SDL_hidapi.h
@@ -511,6 +511,8 @@ extern DECLSPEC int SDLCALL SDL_hid_get_indexed_string(SDL_hid_device *dev, int
  *          in the case of failure; call SDL_GetError() for more information.
  *          This struct is valid until the device is closed with
  *          SDL_hid_close().
+ *
+ * \since This function is available since SDL 3.0.0.
  */
 extern DECLSPEC SDL_hid_device_info * SDLCALL SDL_hid_get_device_info(SDL_hid_device *dev);
 
@@ -525,6 +527,8 @@ extern DECLSPEC SDL_hid_device_info * SDLCALL SDL_hid_get_device_info(SDL_hid_de
  * \param buf_size The size of the buffer in bytes.
  * \returns the number of bytes actually copied, or -1 on error; call
  *          SDL_GetError() for more information.
+ *
+ * \since This function is available since SDL 3.0.0.
  */
 extern DECLSPEC int SDLCALL SDL_hid_get_report_descriptor(SDL_hid_device *dev, unsigned char *buf, size_t buf_size);
 
diff --git a/include/SDL3/SDL_video.h b/include/SDL3/SDL_video.h
index 6802f8971ab3..931d6df6b57e 100644
--- a/include/SDL3/SDL_video.h
+++ b/include/SDL3/SDL_video.h
@@ -477,6 +477,7 @@ extern DECLSPEC const SDL_DisplayMode **SDLCALL SDL_GetFullscreenDisplayModes(SD
  * \param h the height in pixels of the desired display mode
  * \param refresh_rate the refresh rate of the desired display mode, or 0.0f
  *                     for the desktop refresh rate
+ * \param include_high_density_modes Boolean to include high density modes in the search
  * \returns a pointer to the closest display mode equal to or larger than the
  *          desired mode, or NULL on error; call SDL_GetError() for more
  *          information.
@@ -1360,6 +1361,7 @@ extern DECLSPEC int SDLCALL SDL_SetWindowFullscreen(SDL_Window *window, SDL_bool
 /**
  * Return whether the window has a surface associated with it.
  *
+ * \param window the window to query
  * \returns SDL_TRUE if there is a surface associated with the window, or
  *          SDL_FALSE otherwise.
  *