[FFmpeg-cvslog] doc/encoders: Document "dvdsub workaround for some players"

[Oliver Fromme]

ffmpeg | branch: master | Oliver Fromme <oliver at fromme.com> | Thu Jul 10 19:41:08 2014 +0200| [699d2107bea0426dd87c94fa9a983de38f0b502d] | committer: Michael Niedermayer

doc/encoders: Document "dvdsub workaround for some players"

Signed-off-by: Michael Niedermayer <michaelni at gmx.at>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=699d2107bea0426dd87c94fa9a983de38f0b502d
---

 doc/encoders.texi |   24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/encoders.texi b/doc/encoders.texi
index 2781574..ce574cf 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -2147,3 +2147,27 @@ For the fastest encoding speed set the @option{qscale} parameter (4 is the
 recommended value) and do not set a size constraint.
 
 @c man end VIDEO ENCODERS
+
+ at chapter Subtitles Encoders
+ at c man begin SUBTITLES ENCODERS
+
+ at section dvdsub
+
+This codec encodes the bitmap subtitle format that is used in DVDs.
+Typically they are stored in VOBSUB file pairs (*.idx + *.sub),
+and they can also be used in Matroska files.
+
+ at subsection Options
+
+ at table @option
+ at item even_rows_fix
+When set to 1, enable a work-around that makes the number of pixel rows
+even in all subtitles.  This fixes a problem with some players that
+cut off the bottom row if the number is odd.  The work-around just adds
+a fully transparent row if needed.  The overhead is low, typically
+one byte per subtitle on average.
+
+By default, this work-around is disabled.
+ at end table
+
+ at c man end SUBTITLES ENCODERS