diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am
index 32553aedd4..b9e3456ae8 100644
--- a/docs/plugins/Makefile.am
+++ b/docs/plugins/Makefile.am
@@ -98,6 +98,7 @@ EXTRA_HFILES = \
$(top_srcdir)/ext/dts/gstdtsdec.h \
$(top_srcdir)/ext/ivorbis/vorbisdec.h \
$(top_srcdir)/ext/faac/gstfaac.h \
+ $(top_srcdir)/ext/faad/gstfaad.h \
$(top_srcdir)/ext/jack/gstjackaudiosrc.h \
$(top_srcdir)/ext/jack/gstjackaudiosink.h \
$(top_srcdir)/ext/kate/gstkateenc.h \
diff --git a/docs/plugins/gst-plugins-bad-plugins-docs.sgml b/docs/plugins/gst-plugins-bad-plugins-docs.sgml
index de312d44a8..4cbe7b330d 100644
--- a/docs/plugins/gst-plugins-bad-plugins-docs.sgml
+++ b/docs/plugins/gst-plugins-bad-plugins-docs.sgml
@@ -43,6 +43,7 @@
+
diff --git a/docs/plugins/gst-plugins-bad-plugins-sections.txt b/docs/plugins/gst-plugins-bad-plugins-sections.txt
index b60dba4845..4cf934a622 100644
--- a/docs/plugins/gst-plugins-bad-plugins-sections.txt
+++ b/docs/plugins/gst-plugins-bad-plugins-sections.txt
@@ -418,6 +418,20 @@ GST_IS_FAAC_CLASS
gst_faac_get_type
+
+element-faad
+faad
+GstFaad
+
+GstFaadClass
+GST_TYPE_FAAD
+GST_FAAD
+GST_IS_FAAD
+GST_FAAD_CLASS
+GST_IS_FAAD_CLASS
+gst_faad_get_type
+
+
element-festival
festival
diff --git a/ext/faad/gstfaad.c b/ext/faad/gstfaad.c
index 55553532f9..de9f32b874 100644
--- a/ext/faad/gstfaad.c
+++ b/ext/faad/gstfaad.c
@@ -18,6 +18,23 @@
* Boston, MA 02111-1307, USA.
*/
+/**
+ * SECTION:element-faad
+ * @seealso: faac
+ *
+ * faad decodes AAC (MPEG-4 part 3) stream.
+ *
+ *
+ * Example launch lines
+ *
+ * gst-launch filesrc location=example.mp4 ! qtdemux ! faad ! audioconvert ! audioresample ! autoaudiosink
+ *
+ *
+ * gst-launch filesrc location=example.adts ! faad ! audioconvert ! audioresample ! autoaudiosink
+ *
+ *
+ */
+
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif