SDL: Update doc: SDL_SoftStretch() and SDL_SoftStretchLinear() #8667

From a4496f7dcf501646244964e2f8b1fc6b697c9e9a Mon Sep 17 00:00:00 2001
From: Sylvain <[EMAIL REDACTED]>
Date: Mon, 18 Dec 2023 15:15:13 +0100
Subject: [PATCH] Update doc: SDL_SoftStretch() and SDL_SoftStretchLinear()
 #8667

---
 include/SDL3/SDL_surface.h | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/include/SDL3/SDL_surface.h b/include/SDL3/SDL_surface.h
index c9e5f765af7e..fcc8c1d2cf5c 100644
--- a/include/SDL3/SDL_surface.h
+++ b/include/SDL3/SDL_surface.h
@@ -862,8 +862,6 @@ extern DECLSPEC int SDLCALL SDL_BlitSurfaceUnchecked
  * Perform a fast, low quality, stretch blit between two surfaces of the same
  * format.
  *
- * **WARNING**: Please use SDL_BlitSurfaceScaled() instead.
- *
  * \param src the SDL_Surface structure to be copied from
  * \param srcrect the SDL_Rect structure representing the rectangle to be
  *                copied
@@ -874,6 +872,9 @@ extern DECLSPEC int SDLCALL SDL_BlitSurfaceUnchecked
  *          SDL_GetError() for more information.
  *
  * \since This function is available since SDL 3.0.0.
+ *
+ * \sa SDL_BlitSurfaceScaled
+ * \sa SDL_SetSurfaceScaleMode
  */
 extern DECLSPEC int SDLCALL SDL_SoftStretch(SDL_Surface *src,
                                             const SDL_Rect *srcrect,
@@ -893,6 +894,9 @@ extern DECLSPEC int SDLCALL SDL_SoftStretch(SDL_Surface *src,
  *          SDL_GetError() for more information.
  *
  * \since This function is available since SDL 3.0.0.
+ *
+ * \sa SDL_BlitSurfaceScaled
+ * \sa SDL_SetSurfaceScaleMode
  */
 extern DECLSPEC int SDLCALL SDL_SoftStretchLinear(SDL_Surface *src,
                                             const SDL_Rect *srcrect,