Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 9495356f authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] DocBook: deprecate V4L2_BUF_TYPE_PRIVATE 



As per decision taken during the 2012 Media Workshop.

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Acked-by: default avatarSakari Ailus <sakari.ailus@iki.fi>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@redhat.com>
parent ff82b211

Documentation/DocBook/media/v4l/compat.xml

+1 −1
Original line number Diff line number Diff line
@@ -1476,7 +1476,7 @@ follows.<informaltable> 
		  </row>

		  <row>

		    <entry><constant>V4L2_BUF_TYPE_PRIVATE_BASE</constant></entry>

		    <entry><constant>V4L2_BUF_TYPE_PRIVATE</constant></entry>

		    <entry><constant>V4L2_BUF_TYPE_PRIVATE</constant> (but this is deprecated)</entry>

		  </row>

		</tbody>

	      </tgroup>

Documentation/DocBook/media/v4l/io.xml

+2 −12
Original line number Diff line number Diff line
@@ -685,18 +685,14 @@ memory, set by the application. See <xref linkend="userp" /> for details. 
	    <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>
@@ -829,12 +825,6 @@ should set this to 0.</entry> 
	    <entry>Buffer for video output overlay (OSD), see <xref

		linkend="osd" />.</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>

	  </row>

	</tbody>

      </tgroup>

    </table>

Documentation/DocBook/media/v4l/vidioc-cropcap.xml

+2 −4
Original line number Diff line number Diff line
@@ -70,10 +70,8 @@ output.</para> 
	    <entry>Type of the data stream, set by the application.

Only these types are valid here:

<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>, and custom (driver

defined) types with code <constant>V4L2_BUF_TYPE_PRIVATE</constant>

and higher. See <xref linkend="v4l2-buf-type" />.</entry>

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> and

<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>. See <xref linkend="v4l2-buf-type" />.</entry>

	  </row>

	  <row>

	    <entry>struct <link linkend="v4l2-rect-crop">v4l2_rect</link></entry>

Documentation/DocBook/media/v4l/vidioc-enum-fmt.xml

+2 −4
Original line number Diff line number Diff line
@@ -81,10 +81,8 @@ Only these types are valid here: 
<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>, and custom (driver

defined) types with code <constant>V4L2_BUF_TYPE_PRIVATE</constant>

and higher. See <xref linkend="v4l2-buf-type" />.</entry>

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant> and

<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>. See <xref linkend="v4l2-buf-type" />.</entry>

	  </row>

	  <row>

	    <entry>__u32</entry>

Documentation/DocBook/media/v4l/vidioc-g-crop.xml

+2 −4
Original line number Diff line number Diff line
@@ -104,10 +104,8 @@ changed and <constant>VIDIOC_S_CROP</constant> returns the 
	    <entry><structfield>type</structfield></entry>

	    <entry>Type of the data stream, set by the application.

Only these types are valid here: <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant>,

<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>, and custom (driver

defined) types with code <constant>V4L2_BUF_TYPE_PRIVATE</constant>

and higher. See <xref linkend="v4l2-buf-type" />.</entry>

<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> and

<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>. See <xref linkend="v4l2-buf-type" />.</entry>

	  </row>

	  <row>

	    <entry>&v4l2-rect;</entry>