diff --git a/ChangeLog b/ChangeLog
index 541f3fef98..4ab79f50db 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-11-03  Christophe Fergeau  <teuf@gnome.org>
+
+	* docs/random/signal: added notes about using BOXED for GstBuffer
+	signal marshallers, not POINTER
+
 2004-11-03  Christophe Fergeau  <teuf@gnome.org>
 
 	* gst/elements/gstfakesink.c: (gst_fakesink_class_init):
diff --git a/docs/random/signal b/docs/random/signal
new file mode 100644
index 0000000000..679a36c122
--- /dev/null
+++ b/docs/random/signal
@@ -0,0 +1,12 @@
+Random notes on signals:
+
+* Use a BOXED (and not a POINTER) marshaller when your signal will have a 
+  GstBuffer argument:
+
+g_signal_new ("handoff", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
+              G_STRUCT_OFFSET (GstIdentityClass, handoff), NULL, NULL,
+              gst_marshal_VOID__BOXED, G_TYPE_NONE, 1,
+              GST_TYPE_BUFFER | G_SIGNAL_TYPE_STATIC_SCOPE);
+
+* For GstBuffers arguments, consider using G_SIGNAL_TYPE_STATIC_SCOPE as it
+  can prevent an extra copy of the buffer