diff --git a/libswscale/swscale.h b/libswscale/swscale.h
index 43ff7e20f5..87e64e2885 100644
--- a/libswscale/swscale.h
+++ b/libswscale/swscale.h
@@ -135,7 +135,7 @@ struct SwsContext *sws_getContext(int srcW, int srcH, enum PixelFormat srcFormat
 /**
  * Scales the image slice in srcSlice and puts the resulting scaled
  * slice in the image in dst. A slice is a sequence of consecutive
- * rows in an image.
+ * rows in an image. Slices can be bottom to top or top to bottom.
  *
  * @param context   the scaling context previously created with
  *                  sws_getContext()