diff --git a/ChangeLog b/ChangeLog
index d26fe86d84..5eacbdf938 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-07-02  Tim-Philipp Müller  <tim at centricular dot net>
+
+	* gst/gstelement.c:
+	  Improve inline API docs for gst_element_remove_pad().
+
 2005-07-01  Ronald S. Bultje  <rbultje@ronald.bitfreak.net>
 
 	* gst/schedulers/gstoptimalscheduler.c:
diff --git a/gst/gstelement.c b/gst/gstelement.c
index 3ec6c2905b..6a509b7b2d 100644
--- a/gst/gstelement.c
+++ b/gst/gstelement.c
@@ -1239,7 +1239,10 @@ gst_element_add_ghost_pad (GstElement * element, GstPad * pad,
  * @pad: the #GstPad to remove from the element.
  *
  * Removes @pad from @element. @pad will be destroyed if it has not been
- * referenced elsewhere.
+ * referenced elsewhere. Normally, only elements remove pads. The only
+ * exception to this are ghost pads which were created by the application
+ * and request pads, which applications can remove using 
+ * gst_element_release_request_pad().
  */
 void
 gst_element_remove_pad (GstElement * element, GstPad * pad)