From 38c5ba90b38843d31ba302e6d70966b1fa94eaf9 Mon Sep 17 00:00:00 2001
From: Thibault Saunier <tsaunier@igalia.com>
Date: Tue, 23 Apr 2019 12:28:23 -0400
Subject: [PATCH] doc: Fix some docstrings

---
 ext/soup/gstsouputils.c    | 2 +-
 gst/goom/flying_stars_fx.c | 8 ++++----
 gst/goom/goom_tools.h      | 2 +-
 gst/rtpmanager/gstrtpbin.c | 2 +-
 gst/rtpmanager/gstrtpmux.h | 3 +--
 sys/v4l2/gstv4l2object.c   | 4 ++--
 6 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/ext/soup/gstsouputils.c b/ext/soup/gstsouputils.c
index 72c1ef12be..243bc0999f 100644
--- a/ext/soup/gstsouputils.c
+++ b/ext/soup/gstsouputils.c
@@ -20,7 +20,7 @@
 #include <libsoup/soup.h>
 #include "gstsouputils.h"
 
-/**
+/*
  * Soup logger funcs
  */
 
diff --git a/gst/goom/flying_stars_fx.c b/gst/goom/flying_stars_fx.c
index de35e7242b..4f97be9c38 100644
--- a/gst/goom/flying_stars_fx.c
+++ b/gst/goom/flying_stars_fx.c
@@ -163,7 +163,7 @@ fs_free (VisualFX * _this)
 }
 
 
-/**
+/*
  * Cree une nouvelle 'bombe', c'est a dire une particule appartenant a une fusee d'artifice.
  */
 static void
@@ -199,7 +199,7 @@ addABomb (FSData * fs, int mx, int my, float radius, float vage, float gravity,
 }
 
 
-/**
+/*
  * Met a jour la position et vitesse d'une particule.
  */
 static void
@@ -213,7 +213,7 @@ updateStar (Star * s)
 }
 
 
-/**
+/*
  * Ajoute de nouvelles particules au moment d'un evenement sonore.
  */
 static void
@@ -282,7 +282,7 @@ fs_sound_event_occured (VisualFX * _this, PluginInfo * info)
 }
 
 
-/**
+/*
  * Main methode of the FX.
  */
 static void
diff --git a/gst/goom/goom_tools.h b/gst/goom/goom_tools.h
index 34f5240fc4..db5c407fe0 100644
--- a/gst/goom/goom_tools.h
+++ b/gst/goom/goom_tools.h
@@ -21,7 +21,7 @@
 
 #include "goom_config.h"
 
-/**
+/*
  * Random number generator wrapper for faster random number.
  */
 
diff --git a/gst/rtpmanager/gstrtpbin.c b/gst/rtpmanager/gstrtpbin.c
index d200cfd7b1..68c680e532 100644
--- a/gst/rtpmanager/gstrtpbin.c
+++ b/gst/rtpmanager/gstrtpbin.c
@@ -2480,7 +2480,7 @@ gst_rtp_bin_class_init (GstRtpBinClass * klass)
    *
    * Enables RTP retransmission on all streams. To control retransmission on
    * a per-SSRC basis, connect to the #GstRtpBin::new-jitterbuffer signal and
-   * set the #GstRtpJitterBuffer::do-retransmission property on the
+   * set the #GstRtpJitterBuffer:do-retransmission property on the
    * #GstRtpJitterBuffer object instead.
    */
   g_object_class_install_property (gobject_class, PROP_DO_RETRANSMISSION,
diff --git a/gst/rtpmanager/gstrtpmux.h b/gst/rtpmanager/gstrtpmux.h
index b94d408bac..65343da3a7 100644
--- a/gst/rtpmanager/gstrtpmux.h
+++ b/gst/rtpmanager/gstrtpmux.h
@@ -51,8 +51,7 @@ typedef struct
 } GstRTPMuxPadPrivate;
 
 
-/**
- * GstRTPMux:
+/* GstRTPMux:
  *
  * The opaque #GstRTPMux structure.
  */
diff --git a/sys/v4l2/gstv4l2object.c b/sys/v4l2/gstv4l2object.c
index 01c5abf4ee..db9fe8858e 100644
--- a/sys/v4l2/gstv4l2object.c
+++ b/sys/v4l2/gstv4l2object.c
@@ -3883,8 +3883,8 @@ gst_v4l2_object_try_format (GstV4l2Object * v4l2object, GstCaps * caps,
 
 /**
  * gst_v4l2_object_acquire_format:
- * @v4l2object the object
- * @info a GstVideoInfo to be filled
+ * @v4l2object: the object
+ * @info: a GstVideoInfo to be filled
  *
  * Acquire the driver choosen format. This is useful in decoder or encoder elements where
  * the output format is choosen by the HW.