[FFmpeg-devel] [PATCH 2/3] doc/encoders: add doc for AAC encoder

[Stefano Sabatini]

On date Monday 2013-09-09 13:41:31 -0700, Timothy Gu encoded:
> On Mon, Sep 9, 2013 at 1:08 AM, Stefano Sabatini <stefasab at gmail.com> wrote:
> > On date Sunday 2013-09-08 17:02:05 -0700, Timothy Gu encoded:
> >> Thanks-to: Kostya Shishkov <kostya.shishkov at gmail.com>
> >> Signed-off-by: Timothy Gu <timothygu99 at gmail.com>
> >> ---
> >>  doc/encoders.texi | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >>  1 file changed, 91 insertions(+)
> >>
> >> diff --git a/doc/encoders.texi b/doc/encoders.texi
> >> index f85e9c6..3ef8f6b 100644
> >> --- a/doc/encoders.texi
> >> +++ b/doc/encoders.texi
> >> @@ -25,6 +25,96 @@ enabled encoders.
> >>  A description of some of the currently available audio encoders
> >>  follows.
> >>
> >> + at anchor{aacenc}
> >> + at section aac
> >> +
> >> +Advanced Audio Coding (AAC) encoder.
> >> +
> >> +This encoder is an experimental FFmpeg-native AAC encoder. Currently only the
> >> +low complexity (AAC-LC) profile is supported. To use this encoder, you must set
> >> + at option{strict} option to @samp{experimental} or lower.
> >> +
> >
> >> +We have done our best to keep this encoder bug-free; however, as this encoder
> >
> > Just my opinion, remove the first sentence since it's too generic.
> >
> >> +is experimental, unexpected behavior may exist from time to time. For a more
> >> +stable AAC encoder, see @ref{libvo-aacenc}. However, be warned that it has a
> >> +worse quality reported by some users.
> >> +
> >
> >> + at c Comment this out until somebody writes the respective documentation.
> >> + at c See also @ref{libfaac}, @ref{libaacplus}, and @ref{libfdk-aac-enc}.
> >> +
> >> + at subsection Options
> >> +
> >> + at table @option
> >> + at item b
> >> +Set bit rate in bits/s. Setting this automatically activates constant bit rate
> >> +(CBR) mode.
> >> +
> >> + at item q
> >> +Set quality for variable bit rate (VBR) mode. This option is valid only using
> >> +the @command{ffmpeg} command-line tool. For library interface users, use
> >> + at option{global_quality}.
> >> +
> >
> >> + at item stereo_mode
> >> +Set stereo encoding mode. Possible values:
> >> +
> >> + at table @samp
> >> + at item auto
> >> +Automatically selected by the encoder.
> >> +
> >> + at item ms_off
> >> +Disable middle/side encoding.
> >> +
> >> + at item ms_force
> >> +Force middle/side encoding.
> >> + at end table
> >
> > Which is the default value?
> 
> All fixed.

Pushed, although I'm not convinced that linking a Japanese document is
a good idea. Thanks.
-- 
FFmpeg = Forgiving and Fundamentalist Mysterious Peaceful Elected Gem