dvb: fix gtk-doc syntax for wrongly formatted comments

This commit is contained in:
Reynaldo H. Verdejo Pinochet 2016-10-23 21:37:46 -07:00
parent 67d0eefb81
commit 3551d61af5
2 changed files with 10 additions and 12 deletions

View file

@ -130,6 +130,8 @@ GST_DEBUG_CATEGORY_STATIC (gstdvbsrc_debug);
#define GST_CAT_DEFAULT (gstdvbsrc_debug)
/**
* NUM_DTV_PROPS:
*
* Can't be greater than DTV_IOCTL_MAX_MSGS but we are
* not using more than 25 for the largest use case (ISDB-T).
*
@ -564,6 +566,8 @@ static gboolean gst_dvbsrc_is_valid_trans_mode (guint delsys, guint mode);
static gboolean gst_dvbsrc_is_valid_bandwidth (guint delsys, guint bw);
/**
* LOOP_WHILE_EINTR:
*
* This loop should be safe enough considering:
*
* 1.- EINTR suggest the next ioctl might succeed
@ -2489,11 +2493,9 @@ gst_dvbsrc_set_fe_params (GstDvbSrc * object, struct dtv_properties *props)
/* first 3 entries are reserved */
n = 3;
/**
* We are not dropping out but issuing a warning in case of wrong
/* We are not dropping out but issuing a warning in case of wrong
* parameter combinations as failover behavior should be mandated
* by the driver. Worst case scenario it will just fail at tuning.
*/
* by the driver. Worst case scenario it will just fail at tuning. */
switch (object->delsys) {
case SYS_DVBS:

View file

@ -515,10 +515,8 @@ parse_channels_conf_from_file (GstElement * dvbbasebin, const gchar * filename,
g_hash_table_insert (params, g_strdup (satellite[j - 2]),
g_strdup (fields[j]));
}
/**
* Some ZAP format variations store freqs in MHz
* but we internally use kHz for DVB-S/S2.
*/
/* Some ZAP format variations store freqs in MHz
* but we internally use kHz for DVB-S/S2. */
if (strlen (fields[1]) < 6) {
g_hash_table_insert (params, g_strdup ("frequency"),
g_strdup_printf ("%d", atoi (fields[1]) * 1000));
@ -600,16 +598,14 @@ parse_and_configure_from_zap_conf_file (GstElement * dvbbasebin,
GHashTable *channels, *params;
gchar *type;
/**
* Assumptions are made here about a format that is loosely
/* Assumptions are made here about a format that is loosely
* defined. Particularly, we assume a given delivery system
* out of counting the number of fields per line. dvbsrc has
* smarter code to auto-detect a delivery system based on
* known-correct combinations of parameters so if you ever
* encounter cases where the delivery system is being
* wrongly set here, just remove the offending
* g_object_set line and let dvbsrc work his magic out.
*/
* g_object_set line and let dvbsrc work his magic out. */
channels = parse_channels_conf_from_file (dvbbasebin, filename, error);