diff --git a/Documentation/DocBook/media/dvb/audio.xml b/Documentation/DocBook/media/dvb/audio.xml
index d64386237207a9f27867fd6e9bee02620ff4c8bb..a7ea56c71a27cc5cebcfd6ea91b8d17dfa9432c4 100644
--- a/Documentation/DocBook/media/dvb/audio.xml
+++ b/Documentation/DocBook/media/dvb/audio.xml
@@ -1,12 +1,16 @@
DVB Audio Device
The DVB audio device controls the MPEG2 audio decoder of the DVB hardware. It
can be accessed through /dev/dvb/adapter0/audio0. Data types and and
-ioctl definitions can be accessed by including linux/dvb/video.h in your
+ioctl definitions can be accessed by including linux/dvb/audio.h in your
application.
Please note that some DVB cards don’t have their own MPEG decoder, which results in
the omission of the audio and video device.
+
+These ioctls were also used by V4L2 to control MPEG decoders implemented in V4L2. The use
+of these ioctls for that purpose has been made obsolete and proper V4L2 ioctls or controls
+have been created to replace that functionality.
Audio Data Types
@@ -558,6 +562,8 @@ role="subsection">AUDIO_SELECT_SOURCE
role="subsection">AUDIO_SET_MUTE
DESCRIPTION
+This ioctl is for DVB devices only. To control a V4L2 decoder use the V4L2
+&VIDIOC-DECODER-CMD; with the V4L2_DEC_CMD_START_MUTE_AUDIO flag instead.
This ioctl call asks the audio device to mute the stream that is currently being
@@ -730,6 +736,8 @@ role="subsection">AUDIO_SET_BYPASS_MODE
role="subsection">AUDIO_CHANNEL_SELECT
DESCRIPTION
+This ioctl is for DVB devices only. To control a V4L2 decoder use the V4L2
+V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK control instead.
This ioctl call asks the Audio Device to select the requested channel if possible.
@@ -772,6 +780,109 @@ role="subsection">AUDIO_CHANNEL_SELECT
&return-value-dvb;
+AUDIO_BILINGUAL_CHANNEL_SELECT
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. It has been replaced by
+the V4L2 V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK control
+for MPEG decoders controlled through V4L2.
+
+This ioctl call asks the Audio Device to select the requested channel for bilingual streams if possible.
+
+
+SYNOPSIS
+
+
+int ioctl(int fd, int request =
+ AUDIO_BILINGUAL_CHANNEL_SELECT, audio_channel_select_t);
+
+
+PARAMETERS
+
+
+int fd
+
+File descriptor returned by a previous call to open().
+
+
+int request
+
+Equals AUDIO_BILINGUAL_CHANNEL_SELECT for this
+ command.
+
+
+audio_channel_select_t
+ch
+
+Select the output format of the audio (mono left/right,
+ stereo).
+
+
+
+&return-value-dvb;
+
+AUDIO_GET_PTS
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. If you need this functionality,
+then please contact the linux-media mailing list (&v4l-ml;).
+
+This ioctl call asks the Audio Device to return the current PTS timestamp.
+
+
+SYNOPSIS
+
+
+int ioctl(int fd, int request =
+ AUDIO_GET_PTS, __u64 *pts);
+
+
+PARAMETERS
+
+
+int fd
+
+File descriptor returned by a previous call to open().
+
+
+int request
+
+Equals AUDIO_GET_PTS for this
+ command.
+
+
+__u64 *pts
+
+
+Returns the 33-bit timestamp as defined in ITU T-REC-H.222.0 / ISO/IEC 13818-1.
+
+
+The PTS should belong to the currently played
+frame if possible, but may also be a value close to it
+like the PTS of the last decoded frame or the last PTS
+extracted by the PES parser.
+
+
+&return-value-dvb;
+
AUDIO_GET_STATUS
DESCRIPTION