[FFmpeg-devel] [PATCH] add documentation to muxers.texi for matroska/webm muxer options

[Alok Ahuja]

diff --git a/doc/muxers.texi b/doc/muxers.texi
index 9d46803..43a7c4e 100644
--- a/doc/muxers.texi
+++ b/doc/muxers.texi
@@ -210,4 +210,67 @@ Alternatively you can write the command as:
 ffmpeg -benchmark -i INPUT -f null -
 @end example

+ at section matroska
+
+Matroska container muxer.
+
+This muxer implements the matroska and webm container specs.
+
+The recognized metadata settings in this muxer are:
+
+ at table @option
+
+ at item title=@var{title name}
+Name provided to a single track
+ at end table
+
+ at table @option
+
+ at item language=@var{language name}
+Specifies the language of the track in the Matroska languages form
+ at end table
+
+ at table @option
+
+ at item STEREO_MODE=@var{mode}
+Stereo 3D video layout of two views in a single video track
+ at table @option
+ at item mono
+video is not stereo
+ at item left_right
+Both views are arranged side by side, Left-eye view is on the left
+ at item bottom_top
+Both views are arranged in top-bottom orientation, Left-eye view is at
bottom
+ at item top_bottom
+Both views are arranged in top-bottom orientation, Left-eye view is on top
+ at item checkerboard_rl
+Each view is arranged in a checkerboard interleaved pattern, Left-eye view
being first
+ at item checkerboard_lr
+Each view is arranged in a checkerboard interleaved pattern, Right-eye view
being first
+ at item row_interleaved_rl
+Each view is constituted by a row based interleaving, Right-eye view is
first row
+ at item row_interleaved_lr
+Each view is constituted by a row based interleaving, Left-eye view is
first row
+ at item col_interleaved_rl
+Both views are arranged in a column based interleaving manner, Right-eye
view is first column
+ at item col_interleaved_lr
+Both views are arranged in a column based interleaving manner, Left-eye
view is first column
+ at item anaglyph_cyan_red
+All frames are in anaglyph format viewable through red-cyan filters
+ at item right_left
+Both views are arranged side by side, Right-eye view is on the left
+ at item anaglyph_green_magenta
+All frames are in anaglyph format viewable through green-magenta filters
+ at item block_lr
+Both eyes laced in one Block, Left-eye view is first
+ at item block_rl
+Both eyes laced in one Block, Right-eye view is first
+ at end table
+ at end table
+
+For example a 3D WebM clip can be created using the following command line:
+ at example
+ffmpeg -i sample_left_right_clip.mpg -an -vcodec libvpx -metadata
STEREO_MODE=left_right -y stereo_clip.webm
+ at end example
+
 @c man end MUXERS