[FFmpeg-devel] [PATCH] doc/filters: extend syntax description for transpose, and add examples

[Stefano Sabatini]

---
 doc/filters.texi |   18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index b9b0ded..e4c16b6 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -3886,7 +3886,12 @@ Default mode is @code{merge}.
 
 Transpose rows with columns in the input video and optionally flip it.
 
-This filter accepts the following named parameters:
+The filter accepts parameters as a list of @var{key}=@var{value}
+pairs, separated by ":". If the key of the first options is omitted,
+the arguments are interpreted according to the following syntax:
+ at example
+transpose=@var{dir}:@var{passthrough}
+ at end example
 
 @table @option
 @item dir
@@ -3945,6 +3950,17 @@ Preserve landscape geometry (when @var{width} >= @var{height}).
 Default value is @code{none}.
 @end table
 
+For example to rotate by 90 degrees clockwise and preserve portrait
+layout:
+ at example
+transpose=dir=1:passthrough=portrait
+ at end example
+
+The command above can also be specified as:
+ at example
+transpose=1:portrait
+ at end example
+
 @section unsharp
 
 Sharpen or blur the input video.
-- 
1.7.9.5