Doxygen updates.
Doxygen updates

Fixes in documentation for:
 src/descriptors/dr_4b.h   document dvbpsi_nvod_ref_s
 src/descriptors/dr_76.h   document CRID_* defines
 src/tables/atsc_eit.h     document all arguments of dvbpsi_atsc_NewEIT()
 src/tables/atsc_ett.h     document all arguments of dvbpsi_atsc_NewETT()
 src/tables/atsc_stt.h     document missing arguments of dvbpsi_atsc_DetachSTT()
 src/tables/atsc_vct.h     document fix for functions dvbpsi_atsc_InitVCT() and dvbpsi_atsc_NewVCT()
 src/tables/bat.h          document arguments of dvbpsi_bat_ts_add()
 src/table/eit.h           document arguments of dvbpsi_eit_init()
 src/tables/sdt.h          remove unused argument from function dvbpsi_sdt_init()
 src/tables/tot.h          remove unused argument from function dvbpsi_tot_init()
SDT: rename i_ts_id to i_extension

The SDT field known as i_ts_id is named i_extension in the struct dvbpsi_psi_section_t.
atsc_vct: fix bad table id

change 0x8C & 0x9C to 0xC8 & 0xC9

Signed-off-by: Michael Krufky <mkrufky@linuxtv.org>
Signed-off-by: Jean-Paul Saman <jpsaman@videolan.org>
src/dvbpsi.c: dvbpsi_decoder_psi_sections_completed: detect gaps in multi section psi tables

The function dvbpsi_decoder_psi_sections_completed() is meant to detect if all
sections of a multi section psi table have arrived. After the rewrite in
commit-id 57c6cd63 it ignored gaps in the arrived sections. This means that
the function now expects that individual sections of multi section psi tables
arrive in order. However the ISO/IEC 13818-1 standard explains in Annex C, C 2ii
that it is allowed to transmit sections out of order.

 "The section_number field allows the sections of a particular table to be reassembled
  in their original order by the decoder. There is no obligation within this Recommendation
  | International Standard that sections must be transmitted in numerical order, but this
  is recommended, unless it is desired to transmit some sections of the table more frequently
  than others, e.g. due to random access considerations."

The p_decoder->p_sections linked list is sequentially ordered and is now changed to detect
a gap in the ordering. This is possible because the first section in a multi-section psi table
is numbered 0.
dvbinfo: use close iso shutdown for UDP sockets.
tables/BAT: doxygen update

- document first argument of dvbpsi_bat_ts_descriptor_add()
tables/atsc_eit.h: Fix doxygen warning.
descriptors/dr_76.h: Doxygen update.
descriptors/dr_4b.h: Doxygen update
On the way to 1.0.0 release.
dvbinfo: extra check
CAT: The p_section->p_payload_start pointer already points to the fist descriptor for this PSI section.

According to ITU-T Rec H.222.0 and the code in dvbpsi_packet_push() the
p_section->p_payload_start pointer already points to the first descriptor for
this PSI table. Adding 5 bytes is plain wrong.
dvbpsi_ValidPSISection: TOT table has a CRC32 and syntax_indicator is '0'.

In the past the b_syntax_indicator field could be used to distinguish between
tables with a CRC32 and those without. However these days this assumption is no
longer valid and the check should be modified to include tables that have a CRC32
even when syntax_indcator is '0'.
configure.ac: automake v1.13 fix.

Rename AM_CONFIG_HEADER to AC_CONFIG_HEADERS
dvbinfo: add comment
privatize dvbpsi_crc32_table

If one needs to calculate the CRC32 outside of libdvbpsi, then they
should use the new dvbpsi_CalculateCRC32() function instead.
TOT: Fix byte offset to first descriptor for this table.

From dvbpsi_packet_push() we can learn that for the TOT table,
with syntax_indicator '0' the p_section->p_payload_start pointer
points to UTC Time field (3 bytes after PSI section start).

To get the byte position of the descriptor loop one needs to add
2 bytes instead of 5, as was previously done.
TOT: Remove unused variable of dvbpsi_tot_t

The member i_crc is not used anymore now the CRC32 can be checked and
generated by the dvbpsi_BuildPSISection() and dvbpsi_ValidPSISection()
functions.
NIT: cleanup and extra check