Merge tag 'kgdb-4.21-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git/danielt...
[sfrench/cifs-2.6.git] / Documentation / media / uapi / dvb / legacy_dvb_apis.rst
1 .. Permission is granted to copy, distribute and/or modify this
2 .. document under the terms of the GNU Free Documentation License,
3 .. Version 1.1 or any later version published by the Free Software
4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
5 .. and no Back-Cover Texts. A copy of the license is included at
6 .. Documentation/media/uapi/fdl-appendix.rst.
7 ..
8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10 .. _legacy_dvb_apis:
11
12 ***************************
13 Digital TV Deprecated APIs
14 ***************************
15
16 The APIs described here **should not** be used on new drivers or applications.
17
18 The DVBv3 frontend API has issues with new delivery systems, including
19 DVB-S2, DVB-T2, ISDB, etc.
20
21 There's just one driver for a very legacy hardware using the Digital TV
22 audio and video APIs. No modern drivers should use it. Instead, audio and
23 video should be using the V4L2 and ALSA APIs, and the pipelines should
24 be set via the Media Controller API.
25
26 .. attention::
27
28    The APIs described here doesn't necessarily reflect the current
29    code implementation, as this section of the document was written
30    for DVB version 1, while the code reflects DVB version 3
31    implementation.
32
33
34 .. toctree::
35     :maxdepth: 1
36
37     frontend_legacy_dvbv3_api
38     video
39     audio