diff --git a/gst/audiovisualizers/gstbaseaudiovisualizer.c b/gst/audiovisualizers/gstbaseaudiovisualizer.c
index 7573440142..3171bc1f8c 100644
--- a/gst/audiovisualizers/gstbaseaudiovisualizer.c
+++ b/gst/audiovisualizers/gstbaseaudiovisualizer.c
@@ -20,7 +20,10 @@
 /**
  * SECTION:gstbaseaudiovisualizer
  *
- * A basclass for scopes. Takes care of re-fitting the audio-rate to video-rate.
+ * A basclass for scopes. It takes care of re-fitting the audio-rate to
+ * video-rate. It also provides several background shading effects. These
+ * effects are applied to a previous picture before the render() implementation
+ * can draw a new frame.
  */
 
 #ifdef HAVE_CONFIG_H
diff --git a/gst/audiovisualizers/gstspectrascope.c b/gst/audiovisualizers/gstspectrascope.c
index a09e944fa3..9ab5419833 100644
--- a/gst/audiovisualizers/gstspectrascope.c
+++ b/gst/audiovisualizers/gstspectrascope.c
@@ -21,8 +21,8 @@
  * SECTION:element-spectrascope
  * @see_also: goom
  *
- * Wavescope is a simple audio visualisation element. It renders the waveforms
- * like on an oscilloscope.
+ * Spectrascope is a simple spectrum visualisation element. It renders the
+ * frequency spectrum as a series of bars.
  *
  * <refsect2>
  * <title>Example launch line</title>
diff --git a/gst/audiovisualizers/gstsynaescope.c b/gst/audiovisualizers/gstsynaescope.c
index 057eddd08e..ac29e68d58 100644
--- a/gst/audiovisualizers/gstsynaescope.c
+++ b/gst/audiovisualizers/gstsynaescope.c
@@ -21,8 +21,8 @@
  * SECTION:element-synaescope
  * @see_also: goom
  *
- * Wavescope is a simple audio visualisation element. It renders the waveforms
- * like on an oscilloscope.
+ * Synaescope is an audio visualisation element. It analyzes frequencies and
+ * out-of phase properties of audio and draws this as clouds of stars.
  *
  * <refsect2>
  * <title>Example launch line</title>
@@ -248,6 +248,7 @@ gst_synae_scope_render (GstBaseAudioVisualizer * bscope, GstBuffer * audio,
     r = sqrt (frr * frr + fir * fir);
     fc = r + l;
 
+    /* out-of-phase'ness for this frequency component */
     clarity = (gint) (((frl + frr) * (frl - frr) + (fil + fir) * (fil - fir)) /
         (((frl + frr) * (frl + frr) + (fil - fir) * (fil - fir) + (frl -
                     frr) * (frl - frr) + (fil + fir) * (fil + fir)) * 256.0));