[SCM] libav/experimental: Document slice ordering assumption done by sws_scale().

[siretart at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit a520e9f23554455c460a63cf2680d1db2312fdf7
Author: Stefano Sabatini <stefano.sabatini-lala at poste.it>
Date:   Fri Oct 30 14:13:25 2009 +0000

    Document slice ordering assumption done by sws_scale().
    
    Originally committed as revision 29804 to svn://svn.mplayerhq.hu/mplayer/trunk/libswscale

diff --git a/libswscale/swscale.h b/libswscale/swscale.h
index 87e64e2..abc23fc 100644
--- a/libswscale/swscale.h
+++ b/libswscale/swscale.h
@@ -135,7 +135,11 @@ 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. Slices can be bottom to top or top to bottom.
+ * rows in an image.
+ *
+ * Slices have to be provided in sequential order, either in
+ * top-bottom or bottom-top order. If slices are provided in
+ * non-sequential order the behavior of the function is undefined.
  *
  * @param context   the scaling context previously created with
  *                  sws_getContext()

-- 
Libav/FFmpeg packaging