diff --git a/ChangeLog b/ChangeLog
index 0fd07ba64b..6b96957a1c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2007-10-01  Wim Taymans  <wim.taymans@gmail.com>
+
+	* docs/libs/gst-plugins-base-libs-docs.sgml:
+	* docs/libs/gst-plugins-base-libs-sections.txt:
+	* gst-libs/gst/rtp/gstrtppayloads.c:
+	Update documentation.
+
 2007-10-01  Wim Taymans  <wim.taymans@gmail.com>
 
 	* gst-libs/gst/rtp/Makefile.am:
diff --git a/docs/libs/gst-plugins-base-libs-docs.sgml b/docs/libs/gst-plugins-base-libs-docs.sgml
index cb75caab60..51cf51ff17 100644
--- a/docs/libs/gst-plugins-base-libs-docs.sgml
+++ b/docs/libs/gst-plugins-base-libs-docs.sgml
@@ -48,6 +48,7 @@
 <!ENTITY GstBaseRtpPayload SYSTEM "xml/gstbasertppayload.xml">
 <!ENTITY GstRtpBuffer SYSTEM "xml/gstrtpbuffer.xml">
 <!ENTITY GstRtcpBuffer SYSTEM "xml/gstrtcpbuffer.xml">
+<!ENTITY GstRtpPayloads SYSTEM "xml/gstrtppayloads.xml">
 <!-- rtsp -->
 <!ENTITY GstRTSPBase64 SYSTEM "xml/gstrtspbase64.xml">
 <!ENTITY GstRTSPConnection SYSTEM "xml/gstrtspconnection.xml">
@@ -198,6 +199,7 @@
       &GstBaseRtpAudioPayload;
       &GstBaseRtpDepayload;
       &GstBaseRtpPayload;
+      &GstRtpPayloads;
       &GstRtpBuffer;
       &GstRtcpBuffer;
     </chapter>
diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index 35d2c7a5cb..1728fdfdc8 100644
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -968,10 +968,58 @@ gst_rtcp_unix_to_ntp
 <SUBSECTION Standard>
 </SECTION>
 
+<SECTION>
+<FILE>gstrtppayloads</FILE>
+<INCLUDE>gst/rtp/gstrtppayload.h</INCLUDE>
+GstRTPPayload
+GST_RTP_PAYLOAD_IS_DYNAMIC
+
+GstRTPPayloadInfo
+
+gst_rtp_payload_info_for_name
+gst_rtp_payload_info_for_pt
+
+<SUBSECTION Standard>
+GST_RTP_PAYLOAD_DYNAMIC_STRING
+GST_RTP_PAYLOAD_G723_53_STRING
+GST_RTP_PAYLOAD_G723_63_STRING
+GST_RTP_PAYLOAD_G728_STRING
+GST_RTP_PAYLOAD_G729_STRING
+GST_RTP_PAYLOAD_GSM_STRING
+GST_RTP_PAYLOAD_H263_STRING
+GST_RTP_PAYLOAD_L16_MONO_STRING
+GST_RTP_PAYLOAD_L16_STEREO_STRING
+GST_RTP_PAYLOAD_MPA_STRING
+GST_RTP_PAYLOAD_MPV_STRING
+GST_RTP_PAYLOAD_PCMA_STRING
+GST_RTP_PAYLOAD_PCMU_STRING
+GST_RTP_PAYLOAD_TS41_STRING
+GST_RTP_PAYLOAD_TS48_STRING
+GST_RTP_PAYLOAD_1016_STRING
+GST_RTP_PAYLOAD_CELLB_STRING
+GST_RTP_PAYLOAD_CN_STRING
+GST_RTP_PAYLOAD_DVI4_11025_STRING
+GST_RTP_PAYLOAD_DVI4_16000_STRING
+GST_RTP_PAYLOAD_DVI4_22050_STRING
+GST_RTP_PAYLOAD_DVI4_8000_STRING
+GST_RTP_PAYLOAD_G721_STRING
+GST_RTP_PAYLOAD_G722_STRING
+GST_RTP_PAYLOAD_G723_53
+GST_RTP_PAYLOAD_G723_63
+GST_RTP_PAYLOAD_G723_STRING
+GST_RTP_PAYLOAD_H261_STRING
+GST_RTP_PAYLOAD_JPEG_STRING
+GST_RTP_PAYLOAD_LPC_STRING
+GST_RTP_PAYLOAD_MP2T_STRING
+GST_RTP_PAYLOAD_NV_STRING
+GST_RTP_PAYLOAD_QCELP_STRING
+GST_RTP_PAYLOAD_TS41
+GST_RTP_PAYLOAD_TS48
+</SECTION>
+
 <SECTION>
 <FILE>gstrtpbuffer</FILE>
 <INCLUDE>gst/rtp/gstrtpbuffer.h</INCLUDE>
-GstRTPPayload
 
 GST_RTP_VERSION
 
@@ -1032,43 +1080,6 @@ gst_rtp_buffer_get_payload
 gst_rtp_buffer_default_clock_rate
 gst_rtp_buffer_compare_seqnum
 gst_rtp_buffer_ext_timestamp
-
-<SUBSECTION Standard>
-GST_RTP_PAYLOAD_DYNAMIC_STRING
-GST_RTP_PAYLOAD_G723_53_STRING
-GST_RTP_PAYLOAD_G723_63_STRING
-GST_RTP_PAYLOAD_G728_STRING
-GST_RTP_PAYLOAD_G729_STRING
-GST_RTP_PAYLOAD_GSM_STRING
-GST_RTP_PAYLOAD_H263_STRING
-GST_RTP_PAYLOAD_L16_MONO_STRING
-GST_RTP_PAYLOAD_L16_STEREO_STRING
-GST_RTP_PAYLOAD_MPA_STRING
-GST_RTP_PAYLOAD_MPV_STRING
-GST_RTP_PAYLOAD_PCMA_STRING
-GST_RTP_PAYLOAD_PCMU_STRING
-GST_RTP_PAYLOAD_TS41_STRING
-GST_RTP_PAYLOAD_TS48_STRING
-GST_RTP_PAYLOAD_1016_STRING
-GST_RTP_PAYLOAD_CELLB_STRING
-GST_RTP_PAYLOAD_CN_STRING
-GST_RTP_PAYLOAD_DVI4_11025_STRING
-GST_RTP_PAYLOAD_DVI4_16000_STRING
-GST_RTP_PAYLOAD_DVI4_22050_STRING
-GST_RTP_PAYLOAD_DVI4_8000_STRING
-GST_RTP_PAYLOAD_G721_STRING
-GST_RTP_PAYLOAD_G722_STRING
-GST_RTP_PAYLOAD_G723_53
-GST_RTP_PAYLOAD_G723_63
-GST_RTP_PAYLOAD_G723_STRING
-GST_RTP_PAYLOAD_H261_STRING
-GST_RTP_PAYLOAD_JPEG_STRING
-GST_RTP_PAYLOAD_LPC_STRING
-GST_RTP_PAYLOAD_MP2T_STRING
-GST_RTP_PAYLOAD_NV_STRING
-GST_RTP_PAYLOAD_QCELP_STRING
-GST_RTP_PAYLOAD_TS41
-GST_RTP_PAYLOAD_TS48
 </SECTION>
 
 # rtsp
diff --git a/gst-libs/gst/rtp/gstrtppayloads.c b/gst-libs/gst/rtp/gstrtppayloads.c
index 63e460e5d6..5207c99e71 100644
--- a/gst-libs/gst/rtp/gstrtppayloads.c
+++ b/gst-libs/gst/rtp/gstrtppayloads.c
@@ -20,6 +20,22 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:gstrtppayloads
+ * @short_description: Helper methods for dealing with RTP payloads
+ * @see_also: gstrtpbuffer
+ *
+ * <refsect2>
+ * <para>
+ * The GstRTPPayloads helper functions makes it easy to deal with static and dynamic
+ * payloads. Its main purpose is to retrieve properties such as the default clock-rate 
+ * and get session bandwidth information.
+ * </para>
+ * </refsect2>
+ *
+ * Last reviewed on 2007-10-01 (0.10.15)
+ */
+
 #include <string.h>
 
 #include "gstrtppayloads.h"