[FFmpeg-devel] [PATCH] doc: add decoders.texi file

[Stefano Sabatini]

---
 doc/decoders.texi |   22 ++++++++++++++++++++++
 doc/ffmpeg.texi   |    1 +
 doc/ffplay.texi   |    1 +
 doc/ffprobe.texi  |    1 +
 4 files changed, 25 insertions(+), 0 deletions(-)
 create mode 100644 doc/decoders.texi

diff --git a/doc/decoders.texi b/doc/decoders.texi
new file mode 100644
index 0000000..359ab39
--- /dev/null
+++ b/doc/decoders.texi
@@ -0,0 +1,22 @@
+ at chapter Decoders
+ at c man begin DECODERS
+
+Decoders are configured elements in FFmpeg which allow the decoding of
+multimedia streams.
+
+When you configure your FFmpeg build, all the supported native decoders
+are enabled by default. Decoders requiring an external library must be enabled
+manually via the corresponding @code{--enable-lib} option. You can list all
+available decoders using the configure option @code{--list-decoders}.
+
+You can disable all the decoders with the configure option
+ at code{--disable-decoders} and selectively enable / disable single decoders
+with the options @code{--enable-decoder=@var{DECODER}} /
+ at code{--disable-decoder=@var{DECODER}}.
+
+The option @code{-codecs} of the ff* tools will display the list of
+enabled decoders.
+
+A description of some of the currently available decoders follows.
+
+ at c man end DECODERS
diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index 70ad6c5..8464251 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -1049,6 +1049,7 @@ file to which you want to add them.
 @c man end EXAMPLES
 
 @include eval.texi
+ at include decoders.texi
 @include encoders.texi
 @include demuxers.texi
 @include muxers.texi
diff --git a/doc/ffplay.texi b/doc/ffplay.texi
index 9e84291..7b99666 100644
--- a/doc/ffplay.texi
+++ b/doc/ffplay.texi
@@ -174,6 +174,7 @@ Seek to percentage in file corresponding to fraction of width.
 @c man end
 
 @include eval.texi
+ at include decoders.texi
 @include demuxers.texi
 @include muxers.texi
 @include indevs.texi
diff --git a/doc/ffprobe.texi b/doc/ffprobe.texi
index 514d19e..ee4ffb9 100644
--- a/doc/ffprobe.texi
+++ b/doc/ffprobe.texi
@@ -111,6 +111,7 @@ with name "STREAM".
 @end table
 @c man end
 
+ at include decoders.texi
 @include demuxers.texi
 @include protocols.texi
 @include indevs.texi
-- 
1.7.2.3