dr_a1.h: update and correct documentation

src/descriptors/dr_a1.h

@@ -35,7 +35,19 @@ extern "C"
 {
 #endif
 
-
+/*****************************************************************************
+ * dvbpsi_service_location_element_s
+ *****************************************************************************/
+/*!
+ * \struct dvbpsi_service_location_element_s
+ * \brief "service location element" structure
+ *
+ * This structure is used to store a decoded server location element.
+ */
+/*!
+ * \typedef struct dvbpsi_service_location_element_s dvbpsi_service_location_element_t
+ * \brief dvbpsi_service_location_element_t typedefinition.
+ */
 typedef struct dvbpsi_service_location_element_s
 {
     uint8_t i_stream_type;     /*!< service stream type */
@@ -47,7 +59,7 @@ typedef struct dvbpsi_service_location_element_s
  * dvbpsi_service_location_dr_s
  *****************************************************************************/
 /*!
- * \struct dvbpsi_service_dr_s
+ * \struct dvbpsi_service_location_dr_s
  * \brief "service" descriptor structure.
  *
  * This structure is used to store a decoded "service location"
@@ -68,7 +80,7 @@ typedef struct dvbpsi_service_location_dr_s
 
 
 /*****************************************************************************
- * dvbpsi_DecodeServiceDataDr
+ * dvbpsi_DecodeServiceLocationDr
  *****************************************************************************/
 /*!
  * \fn dvbpsi_service_dr_t * dvbpsi_DecodeServiceLocationDr(
@@ -82,10 +94,10 @@ dvbpsi_service_location_dr_t
     *dvbpsi_DecodeServiceLocationDr (dvbpsi_descriptor_t * p_descriptor);
 
 /*****************************************************************************
- * dvbpsi_GenServiceDataDr
+ * dvbpsi_GenServiceLocationDr
  *****************************************************************************/
 /*!
- * \fn dvbpsi_descriptor_t * dvbpsi_GenServiceDr(
+ * \fn dvbpsi_descriptor_t * dvbpsi_GenServiceLocationDr(
                         dvbpsi_service_dr_t * p_decoded, bool b_duplicate)
  * \brief "service" descriptor generator.
  * \param p_decoded pointer to a decoded "service" descriptor