1 files changed, 9 insertions, 18 deletions

diff --git a/Documentation/DocBook/media/v4l/io.xml b/Documentation/DocBook/media/v4l/io.xml
index 1885cc0755cb..b5d1cbdc558b 100644
--- a/Documentation/DocBook/media/v4l/io.xml
+++ b/Documentation/DocBook/media/v4l/io.xml
@@ -613,8 +613,8 @@ field is independent of the <structfield>timestamp</structfield> and
             <entry>__u32</entry>
             <entry><structfield>sequence</structfield></entry>
             <entry></entry>
-            <entry>Set by the driver, counting the frames in the
-sequence.</entry>
+            <entry>Set by the driver, counting the frames (not fields!) in
+sequence. This field is set for both input and output devices.</entry>
           </row>
           <row>
             <entry spanname="hspan"><para>In <link
@@ -677,26 +677,24 @@ memory, set by the application. See <xref linkend="userp" /> for details.
             <entry><structfield>length</structfield></entry>
             <entry></entry>
             <entry>Size of the buffer (not the payload) in bytes for the
-            single-planar API. For the multi-planar API should contain the
-            number of elements in the <structfield>planes</structfield> array.
+            single-planar API. For the multi-planar API the application sets
+            this to the number of elements in the <structfield>planes</structfield>
+            array. The driver will fill in the actual number of valid elements in
+            that array.
             </entry>
           </row>
           <row>
             <entry>__u32</entry>
             <entry><structfield>reserved2</structfield></entry>
             <entry></entry>
-            <entry>A place holder for future extensions and custom
-(driver defined) buffer types
-<constant>V4L2_BUF_TYPE_PRIVATE</constant> and higher. Applications
+            <entry>A place holder for future extensions. Applications
 should set this to 0.</entry>
           </row>
           <row>
             <entry>__u32</entry>
             <entry><structfield>reserved</structfield></entry>
             <entry></entry>
-            <entry>A place holder for future extensions and custom
-(driver defined) buffer types
-<constant>V4L2_BUF_TYPE_PRIVATE</constant> and higher. Applications
+            <entry>A place holder for future extensions. Applications
 should set this to 0.</entry>
           </row>
         </tbody>
@@ -827,14 +825,7 @@ should set this to 0.</entry>
             <entry><constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY</constant></entry>
             <entry>8</entry>
             <entry>Buffer for video output overlay (OSD), see <xref
-                linkend="osd" />. Status: <link
-linkend="experimental">Experimental</link>.</entry>
-          </row>
-          <row>
-            <entry><constant>V4L2_BUF_TYPE_PRIVATE</constant></entry>
-            <entry>0x80</entry>
-          <entry>This and higher values are reserved for custom
-(driver defined) buffer types.</entry>
+                linkend="osd" />.</entry>
           </row>
         </tbody>
       </tgroup>