# HG changeset patch
# User iive
# Date 1234650175 0
# Node ID 21e7e2e893795a31c81bd29bab5027a117f72518
# Parent  b4838c71d52ae26256dc31e5c401f5758f881b04
Another attempt to clarify draw_horiz_band() usage.

diff -r b4838c71d52a -r 21e7e2e89379 avcodec.h
--- a/avcodec.h	Sat Feb 14 22:21:17 2009 +0000
+++ b/avcodec.h	Sat Feb 14 22:22:55 2009 +0000
@@ -960,13 +960,13 @@
      * decoder to draw a horizontal band. It improves cache usage. Not
      * all codecs can do that. You must check the codec capabilities
      * beforehand.
-     * The functino is also used by hardware acceleration APIs as a callback
-     * to pass specific (partially decoded) data to the calling application
-     * so that the data can be passed to the rendering hardware.
-     * In that mode all relevant function parameters are inside a special
-     * structure passed by AVFrame in place of the pixel data.
-     * The exact structure depends on the acceleration API.
-     * The application is allowed to make changes in the structure.
+     * The function is also used by hardware acceleration APIs.
+     * It is called at least once during frame decoding to pass
+     * the data needed for hardware render.
+     * In that mode instead of pixel data, AVFrame points to
+     * a structure specific to the acceleration API. The application
+     * reads the structure and can change some fields to indicate progress
+     * or mark state.
      * - encoding: unused
      * - decoding: Set by user.
      * @param height the height of the slice