diff --git a/ChangeLog b/ChangeLog
index 592a631d0e..46969524c8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-08-15  Ronald S. Bultje  <rbultje@ronald.bitfreak.net>
+
+	* docs/pwg/appendix-porting.xml:
+	  Document _set_link_function -> _set_setcaps_function.
+
 2005-08-15  Thomas Vander Stichele  <thomas at apestaart dot org>
 
 	* check/Makefile.am:
diff --git a/docs/pwg/appendix-porting.xml b/docs/pwg/appendix-porting.xml
index 921e276def..0ef2618aa0 100644
--- a/docs/pwg/appendix-porting.xml
+++ b/docs/pwg/appendix-porting.xml
@@ -141,6 +141,19 @@
           decoder or an encoder.
         </para>
       </listitem>
+      <listitem>
+        <para>
+          <function>gst_pad_set_link_function ()</function>, which used to set
+          a function that would be called when a format was negotiated between
+          two <classname>GstPad</classname>s, now sets a function that is
+          called when two elements are linked together in an application. For
+          all practical purposes, you most likely want to use the function
+          <function>gst_pad_set_setcaps_function ()</function>, nowadays, which
+          sets a function that is called when the format streaming over a pad
+          changes (so similar to <function>_set_link_function ()</function> in
+          &GStreamer;-0.8).
+        </para>
+      </listitem>
     </itemizedlist>
   </sect1>
 </chapter>