diff --git a/sys/dvb/gstdvbsrc.c b/sys/dvb/gstdvbsrc.c
index 872c38544c..be2d76d8ce 100644
--- a/sys/dvb/gstdvbsrc.c
+++ b/sys/dvb/gstdvbsrc.c
@@ -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:
diff --git a/sys/dvb/parsechannels.c b/sys/dvb/parsechannels.c
index 70bb53b448..e683992ca8 100644
--- a/sys/dvb/parsechannels.c
+++ b/sys/dvb/parsechannels.c
@@ -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);