Doxygen does not properly form references that span multiple levels,
so instead reword it a bit and manually add the references to what
they should point to.

This avoids Doxygen to interpret <i> and others that look like XML tags
as those, fixing a warning about unknown tags.

Declare proper group, add the file to that group,
group the defines and document them.

Use lists to represents lists of cases.

The FF_PAD_STRUCTURE is too complex for doxygen to be able to
properly handle, resulting in completely broken AVBPrint documentation.

To fix that, tell Doxygen what to expand that macro to.

Avoids doxy to interpret these as internal references forced by the #
character, fixing the warnings:

  warning: explicit link request to 'nanoTime()' could not be resolved
  warning: explicit link request to 'releaseOutputBuffer(int,long)'
  could not be resolved

The intention here was probably to document this as use of
conditionals does not make sense in a comment.

Fixes doxy warning:
  warning: explicit link request to 'if' could not be resolved

Separate the blocks to make the grouping easier to grasp,
add the file properly to the group and fix the file description
incorrectly used as filename, fixing the following doxy warning:

  warning: the name 'Colorspace' supplied as the argument in
  the \file statement is not an input file

This way the related file will be properly grouped with its
corresponding group like it's done in other places in the doxy.

Make it a bit easier to grasp the grouping when not
unnecessarily splitting comment blocks.

Additionally do not try to add lavu_video_stereo3d to itself, resolving
the following doxy warning:
  warning: Refusing to add group lavu_video_stereo3d to itself

This way the related file will be properly grouped with its
corresponding group like it's done in other places in the doxy.

Make it a bit easier to grasp the grouping when not
unnecessarily splitting comment blocks.

Additionally do not try to add lavu_video_spherical to itself, resolving
the following doxy warning:
  warning: Refusing to add group lavu_video_spherical to itself

This way the related file will be properly grouped with its
corresponding group like it's done in other places in the doxy.

Make it a bit easier to grasp the grouping when not
unnecessarily splitting comment blocks.

Additionally do not try to add lavu_video_display to itself, resolving
the following doxy warning:
  warning: Refusing to add group lavu_video_display to itself

So it will be properly listed along the other crypto modules
in the documentation.

Same as done for other HW decoders, that way it will be
properly listed on the relevant module page.

This is clearly supposed to be a doxy comment and needed to properly
close the group.

Makes it a bit easier to spot the deprecated ones when
looking at the overview.

Before it was cluttering the general avutil Audio group page.

The # is interpreted as explicit reference request by Doxygen
which is not desired here, use markdown inline code to avoid
that.

Mostly re-indenting and adding some missing references.

The //< comment is not any magic comment supported by Doxygen,
instead use ///< to mark them as doc for the members.

The loop uses a 32-bit accumulator. The current code would only zero
the lower 16 bits thereof.

Signed-off-by: James Almer <jamrial@gmail.com>

Signed-off-by: James Almer <jamrial@gmail.com>

Signed-off-by: Andreas Rheinhardt <andreas.rheinhardt@outlook.com>