diff --git a/ges/ges-base-effect.c b/ges/ges-base-effect.c
index 0ae0592d0b..84f420d25c 100644
--- a/ges/ges-base-effect.c
+++ b/ges/ges-base-effect.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:ges-base-effect
  * @short_description: adds an effect to a stream in a GESSourceClip or a
- * #GESLayer
+ * GESLayer
  */
 
 #include <glib/gprintf.h>
diff --git a/ges/ges-effect-clip.c b/ges/ges-effect-clip.c
index 8808f1dc5c..7ecd8b9578 100644
--- a/ges/ges-effect-clip.c
+++ b/ges/ges-effect-clip.c
@@ -20,7 +20,7 @@
 /**
  * SECTION: ges-effect-clip
  * @short_description: An effect created by parse-launch style bin descriptions
- * in a #GESLayer
+ * in a GESLayer
  *
  * The effect will be applied on the sources that have lower priorities
  * (higher number) between the inpoint and the end of it.
diff --git a/ges/ges-effect.c b/ges/ges-effect.c
index bee9e267b0..30b0b1cd89 100644
--- a/ges/ges-effect.c
+++ b/ges/ges-effect.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:ges-effect
  * @short_description: adds an effect build from a parse-launch style 
- * bin description to a stream in a #GESSourceClip or a #GESLayer
+ * bin description to a stream in a GESSourceClip or a GESLayer
  */
 
 #include "ges-internal.h"
diff --git a/ges/ges-test-clip.c b/ges/ges-test-clip.c
index 5c5eac0c90..0b2fd082d7 100644
--- a/ges/ges-test-clip.c
+++ b/ges/ges-test-clip.c
@@ -20,13 +20,12 @@
 
 /**
  * SECTION:ges-test-clip
- * @short_description: Render video and audio test patterns in a
- * #GESLayer
+ * @short_description: Render video and audio test patterns in a GESLayer
  *
  * Useful for testing purposes.
  *
- * You can use the ges_asset_request_simple API to create a Asset
- * capable of extractinf GESTestClip-s
+ * You can use the ges_asset_request_simple API to create an Asset
+ * capable of extracting GESTestClip-s
  */
 
 #include "ges-internal.h"
diff --git a/ges/ges-text-overlay.c b/ges/ges-text-overlay.c
index 070d7b6e6e..b9dbc60c21 100644
--- a/ges/ges-text-overlay.c
+++ b/ges/ges-text-overlay.c
@@ -20,8 +20,7 @@
 
 /**
  * SECTION:ges-text-overlay
- * @short_description: render text onto another video stream in a
- * #GESLayer
+ * @short_description: render text onto another video stream in a GESLayer
  *
  */
 
diff --git a/ges/ges-transition-clip.c b/ges/ges-transition-clip.c
index d6e64d01e8..2d986898b0 100644
--- a/ges/ges-transition-clip.c
+++ b/ges/ges-transition-clip.c
@@ -20,8 +20,7 @@
 
 /**
  * SECTION: ges-transition-clip
- * @short_description: Transition from one clip to another in a
- * #GESLayer
+ * @short_description: Transition from one clip to another in a GESLayer
  *
  * Creates an object that mixes together the two underlying objects, A and B.
  * The A object is assumed to have a higher prioirity (lower number) than the