diff --git a/libswscale/swscale.h b/libswscale/swscale.h
index 5d0c9e9049..dd4de76b0a 100644
--- a/libswscale/swscale.h
+++ b/libswscale/swscale.h
@@ -187,6 +187,7 @@ void sws_freeContext(struct SwsContext *swsContext);
  * @return a pointer to an allocated context, or NULL in case of error
  * @note this function is to be removed after a saner alternative is
  *       written
+ * @deprecated Use sws_getCachedContext() instead.
  */
 struct SwsContext *sws_getContext(int srcW, int srcH, enum PixelFormat srcFormat,
                                   int dstW, int dstH, enum PixelFormat dstFormat,