Found-by: Mateusz "j00ru" Jurczyk and Gynvael Coldwind
CC: libav-stable@libav.org
Signed-off-by: Kostya Shishkov <kostya.shishkov@gmail.com>

Break some of the longer sections into smaller sensible pieces;
make some option descriptions and option ordering more consistent.

The first frame pts must be saved until we have 8 frames since RoQ audio
requires 8 frames in the first packet.

Update FATE references due to encoder delay.

Encoder output is delayed by several frames, so we keep a queue of input
frame timing info to match up with corresponding output packets.

FATE reference updated due timestamp rounding because of resampling from
44100 Hz to 16000 Hz in avconv.

Update FATE references due to encoder delay.

This simplifies matching of timestamps between input frames and output
packets.

Fixes a memleak when using the -frames option with audio.

There is no reason for it to be public, it's only meant to be used
internally.

The caller can achieve the same effect (i.e. getting raw unparsed/mangled
packets) with av_read_frame() and AVFMT_FLAG_NOPARSE |
AVFMT_FLAG_NOFILLIN

Takes encoder delay into account by comparing first the coded page
duration with the calculated page duration. Handles last packet duration
if needed, also by comparing coded duration with calculated duration.
Also does better handling of timestamp generation for packets in the
first page for streamed ogg files where the start time is not
necessarily zero.

5 FATE test references updated due to using demuxer-generated timestamps that
are either not sample-accurate or are slightly off in the input file.

Also fixes stream duration calculation.

The values in the header refer to decoded data, not compressed data.

Do not output an extra packet when out_size is reached.
Also return AVERROR_EOF instead of AVERROR(EIO).

The packet duration is always 28 samples.

This fixes decoding of Bink files with non-multiple-of-16 width.

This fixes doc generation in build tree separate from source.
Signed-off-by: Mans Rullgard <mans@mansr.com>