From 2c69684b80fc2ae6f6313147b6987ef7dc8bf087 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim-Philipp=20M=C3=BCller?= <tim@centricular.net>
Date: Wed, 22 Aug 2012 10:30:04 +0100
Subject: [PATCH] gdkpixbufsink: minor docs improvement

---
 ext/gdk_pixbuf/gstgdkpixbufsink.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/ext/gdk_pixbuf/gstgdkpixbufsink.c b/ext/gdk_pixbuf/gstgdkpixbufsink.c
index bb7d0c827f..bde9e4afa0 100644
--- a/ext/gdk_pixbuf/gstgdkpixbufsink.c
+++ b/ext/gdk_pixbuf/gstgdkpixbufsink.c
@@ -38,7 +38,11 @@
  * </listitem>
  * <listitem>
  * Retrieving the current pixbuf via the #GstGdkPixbufSink:last-pixbuf property
- * when needed.
+ * when needed. This is the easiest way to get at pixbufs for snapshotting
+ * purposes - just wait until the pipeline is prerolled (ASYNC_DONE message
+ * on the bus), then read the property. If you use this method, you may want
+ * to disable message posting by setting the #GstGdkPixbufSink:post-messages
+ * property to #FALSE. This avoids unnecessary memory overhead.
  * </listitem>
  * </itemizedlist>
  *