[FFmpeg-cvslog] doc/muxers: Document use case of mpegts muxer option tables_version

[Andrey Utkin]

ffmpeg | branch: master | Andrey Utkin <andrey.krieger.utkin at gmail.com> | Sun Aug  4 12:25:57 2013 +0300| [27cc3e72f8502d6239dcd0f1dd3fe73f1c85355d] | committer: Michael Niedermayer

doc/muxers: Document use case of mpegts muxer option tables_version

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

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

 doc/muxers.texi |   12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/muxers.texi b/doc/muxers.texi
index a3a1878..d204188 100644
--- a/doc/muxers.texi
+++ b/doc/muxers.texi
@@ -535,6 +535,18 @@ Preserve original timestamps, if value is set to 1. Default value is -1, which
 results in shifting timestamps so that they start from 0.
 @item -tables_version @var{number}
 Set PAT, PMT and SDT version (default 0, valid values are from 0 to 31, inclusively).
+This option allows updating stream structure so that standard consumer may
+detect the change. To do so, reopen output AVFormatContext (in case of API
+usage) or restart ffmpeg instance, cyclically changing tables_version value:
+ at example
+ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111
+ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111
+...
+ffmpeg -i source3.ts -codec copy -f mpegts -tables_version 31 udp://1.1.1.1:1111
+ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111
+ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111
+...
+ at end example
 @end table
 
 Option mpegts_flags may take a set of such flags: