[FFmpeg-cvslog] doc/formats: add section describing stream specifiers

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Sat Jul  6 10:27:19 2013 +0200| [b3ac8a2a606c65157151a08860cc62128c415682] | committer: Stefano Sabatini

doc/formats: add section describing stream specifiers

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

 doc/formats.texi |   31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/doc/formats.texi b/doc/formats.texi
index 6e69bfa..e179755 100644
--- a/doc/formats.texi
+++ b/doc/formats.texi
@@ -141,6 +141,37 @@ increase performance in some cases.
 
 @c man end FORMAT OPTIONS
 
+ at anchor{Format stream specifiers}
+ at section Format stream specifiers
+
+Format stream specifiers allow selection of one or more streams that
+match specific properties.
+
+Possible forms of stream specifiers are:
+ at table @option
+ at item @var{stream_index}
+Matches the stream with this index.
+
+ at item @var{stream_type}[:@var{stream_index}]
+ at var{stream_type} is one of following: 'v' for video, 'a' for audio,
+'s' for subtitle, 'd' for data, and 't' for attachments. If
+ at var{stream_index} is given, then it matches the stream number
+ at var{stream_index} of this type. Otherwise, it matches all streams of
+this type.
+
+ at item p:@var{program_id}[:@var{stream_index}]
+If @var{stream_index} is given, then it matches the stream with number
+ at var{stream_index} in the program with the id
+ at var{program_id}. Otherwise, it matches all streams in the program.
+
+ at item #@var{stream_id}
+Matches the stream by a format-specific ID.
+ at end table
+
+The exact semantics of stream specifiers is defined by the
+ at code{avformat_match_stream_specifier()} function declared in the
+ at file{libavformat/avformat.h} header.
+
 @include demuxers.texi
 @include muxers.texi
 @include metadata.texi