[FFmpeg-devel] [PATCH] doc/filters: document the unstability of the shorthand options notation.

[Nicolas George]

Signed-off-by: Nicolas George <george at nsup.org>
---
 doc/filters.texi | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/filters.texi b/doc/filters.texi
index 7e5a9a625a..886cd5a7e8 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -161,6 +161,11 @@ follow the same constraints order of the previous point. The following
 
 @end itemize
 
+Future evolutions of filters may require inserting new options or changing
+their order, especially for the non-essential options, and that would break
+options given without their name. For that reason, uses that require
+stability should favor the @var{key=value} notation.
+
 If the option value itself is a list of items (e.g. the @code{format} filter
 takes a list of pixel formats), the items in the list are usually separated by
 @samp{|}.
-- 
2.13.2