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

Commit 079dda54 authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] DocBook media: drop 'experimental' annotations 



Drop the 'experimental' annotations. The only remaining part of the API
that is still marked 'experimental' are the debug ioctls/structs, and
that is intentional. Only the v4l2-dbg application should use those.

All others have been around for years, so it is time to drop the
'experimental' designation.

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
parent 57c75987

Documentation/DocBook/media/v4l/compat.xml

+0 −38
Original line number Diff line number Diff line
@@ -2685,10 +2685,6 @@ hardware may support both.</para> 
and may change in the future.</para>



      <itemizedlist>

        <listitem>

	  <para>Video Output Overlay (OSD) Interface, <xref

	    linkend="osd" />.</para>

        </listitem>

        <listitem>

	  <para>&VIDIOC-DBG-G-REGISTER; and &VIDIOC-DBG-S-REGISTER;

ioctls.</para>
@@ -2696,40 +2692,6 @@ ioctls.</para> 
        <listitem>

	  <para>&VIDIOC-DBG-G-CHIP-INFO; ioctl.</para>

        </listitem>

        <listitem>

	  <para>&VIDIOC-ENUM-DV-TIMINGS;, &VIDIOC-QUERY-DV-TIMINGS; and

	  &VIDIOC-DV-TIMINGS-CAP; ioctls.</para>

        </listitem>

        <listitem>

	  <para>Flash API. <xref linkend="flash-controls" /></para>

        </listitem>

        <listitem>

	  <para>&VIDIOC-CREATE-BUFS; and &VIDIOC-PREPARE-BUF; ioctls.</para>

        </listitem>

        <listitem>

	  <para>Selection API. <xref linkend="selection-api" /></para>

        </listitem>

        <listitem>

	  <para>Sub-device selection API: &VIDIOC-SUBDEV-G-SELECTION;

	  and &VIDIOC-SUBDEV-S-SELECTION; ioctls.</para>

        </listitem>

        <listitem>

	  <para>Support for frequency band enumeration: &VIDIOC-ENUM-FREQ-BANDS; ioctl.</para>

        </listitem>

        <listitem>

	  <para>Vendor and device specific media bus pixel formats.

	    <xref linkend="v4l2-mbus-vendor-spec-fmts" />.</para>

        </listitem>

        <listitem>

	  <para>Importing DMABUF file descriptors as a new IO method described

	  in <xref linkend="dmabuf" />.</para>

        </listitem>

        <listitem>

	  <para>Exporting DMABUF files using &VIDIOC-EXPBUF; ioctl.</para>

        </listitem>

        <listitem>

	  <para>Software Defined Radio (SDR) Interface, <xref linkend="sdr" />.</para>

        </listitem>

      </itemizedlist>

    </section>

Documentation/DocBook/media/v4l/controls.xml

+0 −31
Original line number Diff line number Diff line
@@ -4272,13 +4272,6 @@ manually or automatically if set to zero. Unit, range and step are driver-specif 
    <section id="flash-controls">

      <title>Flash Control Reference</title>



      <note>

	<title>Experimental</title>



	<para>This is an <link linkend="experimental">experimental</link>

interface and may change in the future.</para>

      </note>



      <para>

	The V4L2 flash controls are intended to provide generic access

	to flash controller devices. Flash controller devices are
@@ -4743,14 +4736,6 @@ interface and may change in the future.</para> 
    <section id="image-source-controls">

      <title>Image Source Control Reference</title>



      <note>

	<title>Experimental</title>



	<para>This is an <link

	linkend="experimental">experimental</link> interface and may

	change in the future.</para>

      </note>



      <para>

	The Image Source control class is intended for low-level

	control of image source devices such as image sensors. The
@@ -4862,14 +4847,6 @@ interface and may change in the future.</para> 
    <section id="image-process-controls">

      <title>Image Process Control Reference</title>



      <note>

	<title>Experimental</title>



	<para>This is an <link

	linkend="experimental">experimental</link> interface and may

	change in the future.</para>

      </note>



      <para>

	The Image Process control class is intended for low-level control of

	image processing functions. Unlike
@@ -4955,14 +4932,6 @@ interface and may change in the future.</para> 
    <section id="dv-controls">

      <title>Digital Video Control Reference</title>



      <note>

	<title>Experimental</title>



	<para>This is an <link

	linkend="experimental">experimental</link> interface and may

	change in the future.</para>

      </note>



      <para>

	The Digital Video control class is intended to control receivers

	and transmitters for <ulink url="http://en.wikipedia.org/wiki/Vga">VGA</ulink>,

Documentation/DocBook/media/v4l/dev-sdr.xml

+0 −6
Original line number Diff line number Diff line 
  <title>Software Defined Radio Interface (SDR)</title>



  <note>

    <title>Experimental</title>

    <para>This is an <link linkend="experimental"> experimental </link>

    interface and may change in the future.</para>

  </note>



  <para>

SDR is an abbreviation of Software Defined Radio, the radio device

which uses application software for modulation or demodulation. This interface

Documentation/DocBook/media/v4l/dev-subdev.xml

+0 −6
Original line number Diff line number Diff line 
  <title>Sub-device Interface</title>



  <note>

    <title>Experimental</title>

    <para>This is an <link linkend="experimental">experimental</link>

    interface and may change in the future.</para>

  </note>



  <para>The complex nature of V4L2 devices, where hardware is often made of

  several integrated circuits that need to interact with each other in a

  controlled way, leads to complex V4L2 drivers. The drivers usually reflect

Documentation/DocBook/media/v4l/io.xml

+0 −6
Original line number Diff line number Diff line
@@ -475,12 +475,6 @@ rest should be evident.</para> 
  <section id="dmabuf">

    <title>Streaming I/O (DMA buffer importing)</title>



    <note>

      <title>Experimental</title>

      <para>This is an <link linkend="experimental">experimental</link>

      interface and may change in the future.</para>

    </note>



<para>The DMABUF framework provides a generic method for sharing buffers

between multiple devices. Device drivers that support DMABUF can export a DMA

buffer to userspace as a file descriptor (known as the exporter role), import a