Fix not document functions and wrongly documented functions.

Correct function definitions in doxygen blocks.

All dvbpsi decoders now use dvbpsi_t as handle instead of
dvbpsi_decoder_t *. The pointer to dvbpsi_decoder_t is privatized
and accessible through (dvbpsi_t *)->p_private member. The user
must make sure to cast it to the correct dvbpsi_*_decoder_t type
before accessing structure members.

Dvbpsi decoder developers should use the define DVBPSI_DECODER_COMMON
at the start of a new dvbpsi_*_decoder_t.

WARNING: THIS COMMIT BREAKS THE EXISTING API IN A MAJOR WAY !!!

- most public APIs requires a pointer to existing dvbpsi_t
- new functions to obtain and delete a pointer to dvbpsi_t structure:
  dvbpsi_NewHandle() and dvbpsi_DeleteHandle()
- subtable descriptors fixes
- indentations

The descriptor structs have no reference to dvbpsi_h handle, so using
the dvbpsi_message_cb is currently impossible. Therefor remove the
dvbpsi_error() messages for now.

Follow up of commit id: 1f223e37

Use a message callback of dvbpsi_h instead of printf. The decoder
table functions all use a decoder_t. In dvbpsi.h a decoder_t * is
typedefed as dvbpsi_h.
Table encoder (or generators) do not use a dvbpsi_h handle. The
DVBPSI_{ERROR,DEBUG} have been disabled in these functions for now.

The descriptors will be done in another commit.

Libdvbpsi used printf and fprintf to return debug and error information to the caller.
This bypasses any logging mechanism the calling application uses and does not take
multi-threaded applications into account.
The unifying of messages (error, debug or warning) allows a calling application to
filter (message level: -1, 0, 1 or 2) and handle the messages in its own way.

- add --std=gnu99
- add -D_GNU_SOURCE
- remove DEBUG define in preparation of message callback.

Update documentation information and fix structure somewhat.

Raise warnings to error level and break compilation.

Replace

  unsigned int i;
  for(i = 0; ...)

with

  for(unsigned int i=; ...)

Fixed compiler warning in function TSHandle(), which passed a 'const uint8_t *' into
dvbpsi_PushPacket() that expected a 'uint8_t *'.

Original patch was modified by Jean-Paul Saman <jpsaman@videolan.org>
- changed license to LGPLv2.1
- general cleanup
- fixed memleaks
- add missing prototypes to bat_private.h
- add static to functions in example/decode_bat.c

Update license information

All original authors and contributors have been contacted and asked the
question: "Do you agree with relicensing libdvbpsi under the LGPLv2.1 ?".

All original authors contributors and responded positively to this request
as summurized in this commit log:

  Authors and committers                        GPLv2 -> LGPLv2.1 License change
================================================================================
  Arnaud de Bossoreille de Ribou <bozo@via.ecp.fr>                 Yes
  Johan Bilien <jobi@via.ecp.fr>                                   Yes
  Johann Hanne <jhml@gmx.net>                                      Yes
  Andrew John Hughes <gnu_andrew@member.fsf.org>                   Yes
  Tristan Leteurtre <tristan.leteurtre@anevia.com>                 Yes
  Damien Lucas <damien.lucas@anevia.com>                           Yes
  Viktor Luzin <vl@msp.ru>                                         Yes
  Christophe Massiot <massiot@via.ecp.fr>                          Yes
  Jiri Pinkava <jiri.pinkava@vscht.cz>                             Yes
  Jean-Paul Saman <jpsaman@videolan.org>                           Yes
  Gildas Bazin <gbazin@videolan.org>                               Yes
  Derk-Jan Hartman <thedj@videolan.org>                            Yes
  Sam Hocevar <sam@videolan.org>                                   Yes
  Sigmund Augdal <dnumgis@videolan.org>                            Yes
  Laurent Aimar <fenrir@videolan.org>                              Yes

From SCTE 35 (2004) specification.

From SCTE 35 2004 specification

Take it from your distro if you need it

- added libdvbpsi.spec.in
- generate libdvbpsi.spec from configure