SDL: Sync wiki -> header (8b230)

From 8b23029d23d7eb7917a49aaaa228004f16ddfae7 Mon Sep 17 00:00:00 2001
From: SDL Wiki Bot <[EMAIL REDACTED]>
Date: Tue, 28 Sep 2021 17:03:06 +0000
Subject: [PATCH] Sync wiki -> header

---
 include/SDL_audio.h      | 9 ++++-----
 include/SDL_clipboard.h  | 9 +++++----
 include/SDL_cpuinfo.h    | 2 +-
 include/SDL_error.h      | 4 ++--
 include/SDL_filesystem.h | 2 +-
 include/SDL_surface.h    | 2 +-
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/include/SDL_audio.h b/include/SDL_audio.h
index 4714c17539..69b12a315e 100644
--- a/include/SDL_audio.h
+++ b/include/SDL_audio.h
@@ -521,7 +521,7 @@ extern DECLSPEC int SDLCALL SDL_GetAudioDeviceSpec(int index,
  * For example, if you ask for float32 audio format, but the sound card only
  * supports int16, SDL will set the hardware to int16. If you had set
  * SDL_AUDIO_ALLOW_FORMAT_CHANGE, SDL will change the format in the `obtained`
- * structure. If that flag was *not* set, SDL will prepare to convert your
+ * structure. If that flag was *not'' set, SDL will prepare to convert your
  * callback's float32 audio to int16 before feeding it to the hardware and
  * will keep the originally requested format in the `obtained` structure.
  *
@@ -994,10 +994,9 @@ extern DECLSPEC void SDLCALL SDL_MixAudioFormat(Uint8 * dst,
  * You should not call SDL_LockAudio() on the device before queueing; SDL
  * handles locking internally for this function.
  *
- * Note that SDL2
- * [https://discourse.libsdl.org/t/sdl2-support-for-planar-audio/31263/3 does
- * not support planar audio]. You will need to resample from planar audio
- * formats into a non-planar one (see SDL_AudioFormat) before queuing audio.
+ * Note that SDL2 does not support planar audio. You will need to resample
+ * from planar audio formats into a non-planar one (see SDL_AudioFormat)
+ * before queuing audio.
  *
  * \param dev the device ID to which we will queue audio
  * \param data the data to queue to the device for later playback
diff --git a/include/SDL_clipboard.h b/include/SDL_clipboard.h
index 79e4dcc339..1ed8120532 100644
--- a/include/SDL_clipboard.h
+++ b/include/SDL_clipboard.h
@@ -53,12 +53,13 @@ extern DECLSPEC int SDLCALL SDL_SetClipboardText(const char *text);
 /**
  * Get UTF-8 text from the clipboard, which must be freed with SDL_free().
  *
- * This functions returns NULL if there was not enough memory left for a copy
- * of the clipboard's content.
+ * This functions returns empty string if there was not enough memory left for
+ * a copy of the clipboard's content.
  *
- * \returns the clipboard text on success or NULL on failure; call
+ * \returns the clipboard text on success or an empty string on failure; call
  *          SDL_GetError() for more information. Caller must call SDL_free()
- *          on the returned pointer when done with it.
+ *          on the returned pointer when done with it (even if there was an
+ *          error).
  *
  * \sa SDL_HasClipboardText
  * \sa SDL_SetClipboardText
diff --git a/include/SDL_cpuinfo.h b/include/SDL_cpuinfo.h
index aa3f4bb316..9b6ec7003c 100644
--- a/include/SDL_cpuinfo.h
+++ b/include/SDL_cpuinfo.h
@@ -464,7 +464,7 @@ extern DECLSPEC size_t SDLCALL SDL_SIMDGetAlignment(void);
  *
  * \param len The length, in bytes, of the block to allocate. The actual
  *            allocated block might be larger due to padding, etc.
- * \returns a pointer to thenewly-allocated block, NULL if out of memory.
+ * \returns a pointer to the newly-allocated block, NULL if out of memory.
  *
  * \sa SDL_SIMDAlignment
  * \sa SDL_SIMDRealloc
diff --git a/include/SDL_error.h b/include/SDL_error.h
index f61a200cc8..acdf3f6ba7 100644
--- a/include/SDL_error.h
+++ b/include/SDL_error.h
@@ -72,11 +72,11 @@ extern DECLSPEC int SDLCALL SDL_SetError(SDL_PRINTF_FORMAT_STRING const char *fm
  *
  * The message is only applicable when an SDL function has signaled an error.
  * You must check the return values of SDL function calls to determine when to
- * appropriately call SDL_GetError(). You should _not_ use the results of
+ * appropriately call SDL_GetError(). You should *not* use the results of
  * SDL_GetError() to decide if an error has occurred! Sometimes SDL will set
  * an error string even when reporting success.
  *
- * SDL will _not_ clear the error string for successful API calls. You _must_
+ * SDL will *not* clear the error string for successful API calls. You *must*
  * check return values for failure cases before you can assume the error
  * string applies.
  *
diff --git a/include/SDL_filesystem.h b/include/SDL_filesystem.h
index 9dbd28ff80..ee9920fb1e 100644
--- a/include/SDL_filesystem.h
+++ b/include/SDL_filesystem.h
@@ -55,7 +55,7 @@ extern "C" {
  *
  * - `resource`: bundle resource directory (the default). For example:
  *   `/Applications/SDLApp/MyApp.app/Contents/Resources`
- * - `bundle`: the Bundle directory. Fpr example:
+ * - `bundle`: the Bundle directory. For example:
  *   `/Applications/SDLApp/MyApp.app/`
  * - `parent`: the containing directory of the bundle. For example:
  *   `/Applications/SDLApp/`
diff --git a/include/SDL_surface.h b/include/SDL_surface.h
index 994b3f3388..1986576014 100644
--- a/include/SDL_surface.h
+++ b/include/SDL_surface.h
@@ -640,7 +640,7 @@ extern DECLSPEC SDL_Surface *SDLCALL SDL_ConvertSurface
  *          call SDL_GetError() for more information.
  *
  * \sa SDL_AllocFormat
- * \sa SDL_ConvertSurfaceFormat
+ * \sa SDL_ConvertSurface
  * \sa SDL_CreateRGBSurface
  */
 extern DECLSPEC SDL_Surface *SDLCALL SDL_ConvertSurfaceFormat