[FFmpeg-cvslog] lavfi/avfilter.h: add doxy for AVFilterLink.cur_buf

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Sun Jul 22 11:24:27 2012 +0200| [b73be80d48c690450d80fd317f1495136daa43e9] | committer: Stefano Sabatini

lavfi/avfilter.h: add doxy for AVFilterLink.cur_buf

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=b73be80d48c690450d80fd317f1495136daa43e9
---

 libavfilter/avfilter.h |   15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h
index 229f78d..47435f0 100644
--- a/libavfilter/avfilter.h
+++ b/libavfilter/avfilter.h
@@ -578,7 +578,22 @@ struct AVFilterLink {
      */
     AVFilterBufferRef *src_buf;
 
+    /**
+     * The buffer reference to the frame sent across the link by the
+     * source filter, which is read by the destination filter. It is
+     * automatically set up by ff_start_frame().
+     *
+     * Depending on the permissions, it may either be the same as
+     * src_buf or an automatic copy of it.
+     *
+     * It is automatically freed by the filter system when calling
+     * ff_end_frame(). In case you save the buffer reference
+     * internally (e.g. if you cache it for later reuse), or give it
+     * away (e.g. if you pass the reference to the next filter) it
+     * must be set to NULL before calling ff_end_frame().
+     */
     AVFilterBufferRef *cur_buf;
+
     AVFilterBufferRef *out_buf;
 
     struct AVFilterPool *pool;