[FFmpeg-cvslog] doc/ffmpeg-formats: reword and extend documentation for avoid_negative_ts option

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Mon Mar 18 23:55:19 2013 +0100| [2bac6b6f5ee846348262fe3c9b58334e6e063740] | committer: Stefano Sabatini

doc/ffmpeg-formats: reword and extend documentation for avoid_negative_ts option

Hopefully increase readability.

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

 doc/ffmpeg-formats.texi |   18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/doc/ffmpeg-formats.texi b/doc/ffmpeg-formats.texi
index 0e972a8..2659627 100644
--- a/doc/ffmpeg-formats.texi
+++ b/doc/ffmpeg-formats.texi
@@ -140,12 +140,18 @@ Consider things that a sane encoder should not do as an error.
 Use wallclock as timestamps.
 
 @item avoid_negative_ts @var{integer} (@emph{output})
-Shift timestamps to make them positive. 1 enables, 0 disables, default
-of -1 enables when required by target format.
-When timestamps are shifted, all timestamps of a output file are shifted
-together by the same amount. AV sync, subtitle sync and relative timestamp
-differences are preserved compared to how they would have been without
-shifting.
+Shift timestamps to make them positive. A value of 1 enables shifting,
+a value of 0 disables it, the default value of -1 enables shifting
+when required by the target format.
+
+When shifting is enabled, all output timestamps are shifted by the
+same amount. Audio, video, and subtitles desynching and relative
+timestamp differences are preserved compared to how they would have
+been without shifting.
+
+Also note that this affects only leading negative timestamps, and not
+non-monotonic negative timestamps.
+
 When avoid_negative_ts is used together with copyts, vsync or async then
 avoid_negative_ts is applied last. This is neccessary so that containers
 which do not support negative timestamps wont get any and can be used