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

[Stefano Sabatini]

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

diff --git a/doc/formats.texi b/doc/formats.texi
index 6e69bfa..13e8c45 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
+
+Stream specifiers allow to select one or more streams in a format
+matching 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: 'c' 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
-- 
1.8.1.2