Commit f9b2e8aa authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

media: docs: make DVB documents more compatible with Sphinx 3.1+ 



Sphinx 3.x broke support for the cdomain.py extension, as the
c domain code was rewritten. Due to that, the c tags need to
be re-written, in order to use the new c domain notation.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent 407e84cd

Documentation/userspace-api/media/dvb/audio-bilingual-channel-select.rst

+3 −4
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. c:namespace:: DTV.audio



.. _AUDIO_BILINGUAL_CHANNEL_SELECT:
@@ -16,9 +17,9 @@ AUDIO_BILINGUAL_CHANNEL_SELECT 
Synopsis

--------



.. c:function:: int ioctl(int fd, AUDIO_BILINGUAL_CHANNEL_SELECT, struct *audio_channel_select)

    :name: AUDIO_BILINGUAL_CHANNEL_SELECT

.. c:macro:: AUDIO_BILINGUAL_CHANNEL_SELECT



``int ioctl(int fd, AUDIO_BILINGUAL_CHANNEL_SELECT, struct audio_channel_select *select)``



Arguments

---------
@@ -39,7 +40,6 @@ Arguments 


       -  Select the output format of the audio (mono left/right, stereo).





Description

-----------
@@ -50,7 +50,6 @@ for MPEG decoders controlled through V4L2. 
This ioctl call asks the Audio Device to select the requested channel

for bilingual streams if possible.





Return Value

------------

Documentation/userspace-api/media/dvb/audio-channel-select.rst

+3 −5
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. c:namespace:: DTV.audio



.. _AUDIO_CHANNEL_SELECT:
@@ -16,9 +17,9 @@ AUDIO_CHANNEL_SELECT 
Synopsis

--------



.. c:function:: int ioctl(int fd, AUDIO_CHANNEL_SELECT, struct *audio_channel_select)

    :name: AUDIO_CHANNEL_SELECT

.. c:macro:: AUDIO_CHANNEL_SELECT



``int ioctl(int fd, AUDIO_CHANNEL_SELECT, struct audio_channel_select *select)``



Arguments

---------
@@ -27,7 +28,6 @@ Arguments 
    :header-rows:  0

    :stub-columns: 0





    -



       -  int fd
@@ -40,7 +40,6 @@ Arguments 


       -  Select the output format of the audio (mono left/right, stereo).





Description

-----------
@@ -50,7 +49,6 @@ V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead. 
This ioctl call asks the Audio Device to select the requested channel if

possible.





Return Value

------------

Documentation/userspace-api/media/dvb/audio-clear-buffer.rst

+4 −4
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. c:namespace:: DTV.audio



.. _AUDIO_CLEAR_BUFFER:
@@ -16,8 +17,9 @@ AUDIO_CLEAR_BUFFER 
Synopsis

--------



.. c:function:: int  ioctl(int fd, AUDIO_CLEAR_BUFFER)

    :name: AUDIO_CLEAR_BUFFER

.. c:macro:: AUDIO_CLEAR_BUFFER



``int ioctl(int fd, AUDIO_CLEAR_BUFFER)``



Arguments

---------
@@ -26,7 +28,6 @@ Arguments 
    :header-rows:  0

    :stub-columns: 0





    -  .. row 1



       -  int fd
@@ -39,7 +40,6 @@ Description 
This ioctl call asks the Audio Device to clear all software and hardware

buffers of the audio decoder device.





Return Value

------------

Documentation/userspace-api/media/dvb/audio-continue.rst

+3 −4
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. c:namespace:: DTV.audio



.. _AUDIO_CONTINUE:
@@ -16,9 +17,9 @@ AUDIO_CONTINUE 
Synopsis

--------



.. c:function:: int  ioctl(int fd, AUDIO_CONTINUE)

    :name: AUDIO_CONTINUE

.. c:macro:: AUDIO_CONTINUE



``int ioctl(int fd, AUDIO_CONTINUE)``



Arguments

---------
@@ -27,7 +28,6 @@ Arguments 
    :header-rows:  0

    :stub-columns: 0





    -  .. row 1



       -  int fd
@@ -40,7 +40,6 @@ Description 
This ioctl restarts the decoding and playing process previously paused

with AUDIO_PAUSE command.





Return Value

------------

Documentation/userspace-api/media/dvb/audio-fclose.rst

+1 −6
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. c:namespace:: DTV.audio



.. _audio_fclose:
@@ -17,8 +18,6 @@ Synopsis 
--------



.. c:function:: int close(int fd)

    :name: dvb-audio-close





Arguments

---------
@@ -27,20 +26,17 @@ Arguments 
    :header-rows:  0

    :stub-columns: 0





    -  .. row 1



       -  int fd



       -  File descriptor returned by a previous call to open().





Description

-----------



This system call closes a previously opened audio device.





Return Value

------------
@@ -48,7 +44,6 @@ Return Value 
    :header-rows:  0

    :stub-columns: 0





    -  .. row 1



       -  ``EBADF``