This shrinks the tool manuals to a manageable size. Relevant manuals are
referenced in the "See Also" chapter.

Overall documentation inclusion should still be possible through the use
of a conditional variable set during configuration time, if someone feels
the need for a huge-wall-of-text-fashioned manual.

The metadata muxer/demuxer belongs to the formats documentation.

It's confusing and not necessary, especially in the introduction.

In particular, make "See Also" chapter rendered in HTML output.

In particular, make "See Also" chapter rendered in HTML output.

Add more references, and generate alternative variants for HTML and POD
output. In particular, this allows to render a "See Also" chapter in the
HTML output.

Fix syntax, remove pointless introductory sentence, improve overall
consistency.

Factorize.

Ignore @c man begin ... @c man end comments, rely on @chapter for marking
the beginning of the various manual top level sections.

This allows us to write markup which is not dependent on the specific
texi2pod.pl implementation.

This change causes a few rendering issues, which will be fixed in further
patches.

Note that examples are changed.

This breaks usage for out-of-range values.

This will prevent an overflow in the SSSE3 and MMX filter_line code:
delta is expressed as an u16 being shifted by 2 to the left. If it
overflows, having a strength not above 64 will make sure that m is set
to 0 (making the m*m*delta >> 14 expression void).

A value above 64 should not make any sense unless gradfun is used as a
blur filter.

This filter pads an audio stream with silence
It can together with -shortest be used to extend audio streams to
the same length as video.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Ignore the other arguments, which have not to be processed by the POD
renderer.

This allows to clean the doc directory from the parent project dir.
The command:
make -C doc clean

does not work as long as the paths specified in doc/Makefile are relative
to the parent dir.

Also it is consitent with "testclean" and "distclean" targets.

With these commands it is possible to add HTML and non-HTML snippets,
which will be useful for the "See Also" manual chapters.

Fix a few warnings generated when creating the manuals.

Our current doc generation toolchain does not allow to reference external
documents.

Signed-off-by: Peter Ross <pross@xvid.org>

Signed-off-by: Peter Ross <pross@xvid.org>

Signed-off-by: Peter Ross <pross@xvid.org>

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Fail with a meaningfull error message in case of bogus input.

Also the new options are more consistent with the rest of the tool
options, since it does not support generic stream specifiers.

I forgot to merge with the previous commit.

Use it to show difference between shorthand and named parameters.

Also fix documentation accordingly.

Fix trac ticket #2027.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Consistent with the image2 muxer.

Note the time base for the option. Add an additional example description.

Add options introspection, and improve error feedback.

Improve rendering.

The file now contains also an audio select implementation. Also move the
aselect/select documentation from video filters to the multimedia filters
section.

Spotted-by: Tim Nicholson <nichot20@yahoo.com>

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>