redonkable/alistair23-linux
redonkable/alistair23-linux
1
0
Fork 0
Code Releases Activity

[media] DocBook: Document the removal of the old VIDIOC_*_OLD ioctls

Browse source 
Those ioctls passed away. Properly documented it.

Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
This commit is contained in:
Mauro Carvalho Chehab 2011-03-01 10:12:36 -03:00
parent f6a373fb05
commit a602d520ac
1 changed files with 14 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
Documentation/DocBook/v4l/compat.xml
View file

@ -1711,8 +1711,8 @@ ioctl would enumerate the available audio inputs. An ioctl to
determine the current audio input, if more than one combines with the determine the current audio input, if more than one combines with the
current video input, did not exist. So current video input, did not exist. So
<constant>VIDIOC_G_AUDIO</constant> was renamed to <constant>VIDIOC_G_AUDIO</constant> was renamed to
<constant>VIDIOC_G_AUDIO_OLD</constant>, this ioctl will be removed in <constant>VIDIOC_G_AUDIO_OLD</constant>, this ioctl was removed on
the future. The &VIDIOC-ENUMAUDIO; ioctl was added to enumerate Kernel 2.6.39. The &VIDIOC-ENUMAUDIO; ioctl was added to enumerate
audio inputs, while &VIDIOC-G-AUDIO; now reports the current audio audio inputs, while &VIDIOC-G-AUDIO; now reports the current audio
input.</para> input.</para>
<para>The same changes were made to &VIDIOC-G-AUDOUT; and <para>The same changes were made to &VIDIOC-G-AUDOUT; and
@ -1726,7 +1726,7 @@ must be updated to successfully compile again.</para>
<para>The &VIDIOC-OVERLAY; ioctl was incorrectly defined with <para>The &VIDIOC-OVERLAY; ioctl was incorrectly defined with
write-read parameter. It was changed to write-only, while the write-read write-read parameter. It was changed to write-only, while the write-read
version was renamed to <constant>VIDIOC_OVERLAY_OLD</constant>. The old version was renamed to <constant>VIDIOC_OVERLAY_OLD</constant>. The old
ioctl will be removed in the future. Until further the "videodev" ioctl was removed on Kernel 2.6.39. Until further the "videodev"
kernel module will automatically translate to the new version, so drivers kernel module will automatically translate to the new version, so drivers
must be recompiled, but not applications.</para> must be recompiled, but not applications.</para>
</listitem> </listitem>
@ -1744,7 +1744,7 @@ surface can be seen.</para>
defined with write-only parameter, inconsistent with other ioctls defined with write-only parameter, inconsistent with other ioctls
modifying their argument. They were changed to write-read, while a modifying their argument. They were changed to write-read, while a
<constant>_OLD</constant> suffix was added to the write-only versions. <constant>_OLD</constant> suffix was added to the write-only versions.
The old ioctls will be removed in the future. Drivers and The old ioctls were removed on Kernel 2.6.39. Drivers and
applications assuming a constant parameter need an update.</para> applications assuming a constant parameter need an update.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
@ -1815,8 +1815,8 @@ yet to be addressed, for details see <xref
<para>The &VIDIOC-CROPCAP; ioctl was incorrectly defined <para>The &VIDIOC-CROPCAP; ioctl was incorrectly defined
with read-only parameter. It is now defined as write-read ioctl, while with read-only parameter. It is now defined as write-read ioctl, while
the read-only version was renamed to the read-only version was renamed to
<constant>VIDIOC_CROPCAP_OLD</constant>. The old ioctl will be removed <constant>VIDIOC_CROPCAP_OLD</constant>. The old ioctl was removed
in the future.</para> on Kernel 2.6.39.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</section> </section>
@ -2364,6 +2364,14 @@ that used it. It was originally scheduled for removal in 2.6.35.
</listitem> </listitem>
</orderedlist> </orderedlist>
</section> </section>
<section>
<title>V4L2 in Linux 2.6.39</title>
<orderedlist>
<listitem>
<para>The old VIDIOC_*_OLD symbols and V4L1 support were removed.</para>
</listitem>
</orderedlist>
</section>
<section id="other"> <section id="other">
<title>Relation of V4L2 to other Linux multimedia APIs</title> <title>Relation of V4L2 to other Linux multimedia APIs</title>