media: docs: move driver-specific info to driver-api

Those documents don't really describe the driver API.

Instead, they contain development-specific information.

Yet, as the main index file describes the content of it as:

	"how specific kernel subsystems work
	 from the point of view of a kernel developer"

It seems to be the better fit.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
This commit is contained in:
Mauro Carvalho Chehab 2020-03-04 15:54:10 +01:00
parent 32e2eae23f
commit 577a7ad33a
66 changed files with 81 additions and 67 deletions

View File

@ -2,6 +2,34 @@
.. include:: <isonum.txt>
################################################
Video4Linux (V4L) driver-specific documentation
################################################
.. only:: html
.. class:: toc-title
Table of Contents
.. toctree::
:maxdepth: 5
bttv-devel
cpia2_devel
cx2341x-devel
cx88-devel
davinci-vpbe-devel
fimc-devel
pvrusb2
pxa_camera
radiotrack
saa7134-devel
sh_mobile_ceu_camera
tuners
vimc-devel
##############################################
Linux Digital TV driver-specific documentation
##############################################
@ -27,7 +55,6 @@ For more details see the file COPYING in the source distribution of Linux.
.. toctree::
:maxdepth: 5
:numbered:
dvb-usb
frontends

View File

@ -36,3 +36,5 @@ For more details see the file COPYING in the source distribution of Linux.
mc-core
cec-core
csi2
drivers/index

View File

@ -16,7 +16,6 @@ Linux Media Subsystem Documentation
../driver-api/media/index
v4l-drivers/index
dvb-drivers/index
.. only:: html and subproject

View File

@ -31,23 +31,9 @@ For more details see the file COPYING in the source distribution of Linux.
:maxdepth: 5
:numbered:
tuners
max2175
pvrusb2
pxa_camera
radiotrack
sh_mobile_ceu_camera
uvcvideo
bttv-devel
cpia2_devel
cx2341x-devel
cx88-devel
davinci-vpbe-devel
fimc-devel
saa7134-devel
vimc-devel
cx2341x-uapi
imx-uapi
meye-uapi

View File

@ -3667,7 +3667,7 @@ L: linux-media@vger.kernel.org
S: Odd fixes
W: https://linuxtv.org
T: git git://linuxtv.org/media_tree.git
F: Documentation/media/v4l-drivers/bttv*
F: Documentation/driver-api/media/drivers/bttv*
F: drivers/media/pci/bt8xx/bttv*
BUS FREQUENCY DRIVER FOR SAMSUNG EXYNOS
@ -4539,7 +4539,7 @@ L: linux-media@vger.kernel.org
S: Odd fixes
W: https://linuxtv.org
T: git git://linuxtv.org/media_tree.git
F: Documentation/media/v4l-drivers/cx88*
F: Documentation/driver-api/media/drivers/cx88*
F: drivers/media/pci/cx88/
CXD2820R MEDIA DRIVER
@ -13711,7 +13711,7 @@ L: linux-media@vger.kernel.org
S: Maintained
W: http://www.isely.net/pvrusb2/
T: git git://linuxtv.org/media_tree.git
F: Documentation/media/v4l-drivers/pvrusb2*
F: Documentation/driver-api/media/drivers/pvrusb2*
F: drivers/media/usb/pvrusb2/
PWC WEBCAM DRIVER
@ -14720,7 +14720,7 @@ L: linux-media@vger.kernel.org
S: Odd fixes
W: https://linuxtv.org
T: git git://linuxtv.org/media_tree.git
F: Documentation/media/v4l-drivers/saa7134*
F: Documentation/driver-api/media/drivers/saa7134*
F: drivers/media/pci/saa7134/
SAA7146 VIDEO4LINUX-2 DRIVER

View File

@ -14,7 +14,7 @@
* Amaury Demol from DiBcom for providing specs and driver
* sources, on which this driver (and the dvb-dibusb) are based.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef DIB3000_H

View File

@ -14,7 +14,7 @@
* Amaury Demol from DiBcom for providing specs and driver
* sources, on which this driver (and the dvb-dibusb) are based.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

View File

@ -3,7 +3,7 @@
*
* Copyright (C) 2008 Igor M. Liplianin (liplianin@me.by)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef EDS1547

View File

@ -3,7 +3,7 @@
*
* Copyright (C) 2008 Igor M. Liplianin (liplianin@me.by)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef Z0194A

View File

@ -845,7 +845,7 @@ int cx18_start_v4l2_encode_stream(struct cx18_stream *s)
/*
* Audio related reset according to
* Documentation/media/v4l-drivers/cx2341x-devel.rst
* Documentation/driver-api/media/drivers/cx2341x-devel.rst
*/
if (atomic_read(&cx->ana_capturing) == 0)
cx18_vapi(cx, CX18_CPU_SET_MISC_PARAMETERS, 2,
@ -853,7 +853,7 @@ int cx18_start_v4l2_encode_stream(struct cx18_stream *s)
/*
* Number of lines for Field 1 & Field 2 according to
* Documentation/media/v4l-drivers/cx2341x-devel.rst
* Documentation/driver-api/media/drivers/cx2341x-devel.rst
* Field 1 is 312 for 625 line systems in BT.656
* Field 2 is 313 for 625 line systems in BT.656
*/

View File

@ -1016,7 +1016,7 @@ static void pxa_camera_wakeup(struct pxa_camera_dev *pcdev,
* - a videobuffer is queued on the pcdev->capture list
*
* Please check the "DMA hot chaining timeslice issue" in
* Documentation/media/v4l-drivers/pxa_camera.rst
* Documentation/driver-api/media/drivers/pxa_camera.rst
*
* Context: should only be called within the dma irq handler
*/
@ -1438,7 +1438,7 @@ static void pxac_vb2_queue(struct vb2_buffer *vb)
/*
* Please check the DMA prepared buffer structure in :
* Documentation/media/v4l-drivers/pxa_camera.rst
* Documentation/driver-api/media/drivers/pxa_camera.rst
* Please check also in pxa_camera_check_link_miss() to understand why DMA chain
* modification while DMA chain is running will work anyway.
*/

View File

@ -272,7 +272,7 @@ config RADIO_RTRACK
been reported to be used by these cards.
More information is contained in the file
<file:Documentation/media/v4l-drivers/radiotrack.rst>.
<file:Documentation/driver-api/media/drivers/radiotrack.rst>.
To compile this driver as a module, choose M here: the
module will be called radio-aimslab.

View File

@ -7,7 +7,7 @@ config DVB_USB_V2
USB1.1 and USB2.0 DVB devices.
Almost every USB device needs a firmware, please look into
<file:Documentation/media/dvb-drivers/dvb-usb.rst>.
<file:Documentation/driver-api/media/drivers/dvb-usb.rst>.
For a complete list of supported USB devices see the LinuxTV DVB Wiki:
<https://linuxtv.org/wiki/index.php/DVB_USB>

View File

@ -1,7 +1,7 @@
// SPDX-License-Identifier: GPL-2.0-only
/* DVB USB compliant linux driver for GL861 USB2.0 devices.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include <linux/string.h>

View File

@ -39,7 +39,7 @@
* Copyright (C) 2010 Malcolm Priestley (tvboxspy@gmail.com)
* LME2510(C)(C) Leaguerme (Shenzhen) MicroElectronics Co., Ltd.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*
* Known Issues :
* LME2510: Non Intel USB chipsets fail to maintain High Speed on

View File

@ -14,7 +14,7 @@
* MVB0001F (LME2510C+LGTDQT-P001F)
*
* *
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_LME2510_H_
#define _DVB_USB_LME2510_H_

View File

@ -2,7 +2,7 @@
/*
* Copyright (C) 2010-2014 Michael Krufky (mkrufky@linuxtv.org)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include <linux/vmalloc.h>

View File

@ -2,7 +2,7 @@
/*
* Copyright (C) 2010-2014 Michael Krufky (mkrufky@linuxtv.org)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_MXL111SF_H_

View File

@ -8,7 +8,7 @@ config DVB_USB
USB1.1 and USB2.0 DVB devices.
Almost every USB device needs a firmware, please look into
<file:Documentation/media/dvb-drivers/dvb-usb.rst>.
<file:Documentation/driver-api/media/drivers/dvb-usb.rst>.
For a complete list of supported USB devices see the LinuxTV DVB Wiki:
<https://linuxtv.org/wiki/index.php/DVB_USB>

View File

@ -8,7 +8,7 @@
* - AVerMedia who kindly provided information and
* - Glen Harris who suffered from my mistakes during development.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -6,7 +6,7 @@
*
* Thanks to Afatech who kindly provided information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "af9005.h"
#include "af9005-script.h"

View File

@ -8,7 +8,7 @@
*
* Thanks to Afatech who kindly provided information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "af9005.h"
/* debug */

View File

@ -6,7 +6,7 @@
*
* Thanks to Afatech who kindly provided information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "af9005.h"

View File

@ -6,7 +6,7 @@
*
* Thanks to Afatech who kindly provided information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_AF9005_H_
#define _DVB_USB_AF9005_H_

View File

@ -4,7 +4,7 @@
*
* Copyright (C) 2009 Adams.Xu <adams.xu@azwave.com.cn>
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "az6027.h"

View File

@ -18,7 +18,7 @@
* Copyright (C) 2006, 2007 Chris Pascoe (c.pascoe@itee.uq.edu.au)
* Copyright (C) 2011, 2017 Maciej S. Szmigiero (mail@maciej.szmigiero.name)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include <media/tuner.h>
#include <linux/delay.h>

View File

@ -3,7 +3,7 @@
*
* Copyright (C) 2004-5 Patrick Boettcher (patrick.boettcher@posteo.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -7,7 +7,7 @@
* based on GPL code from DiBcom, which has
* Copyright (C) 2004 Amaury Demol for DiBcom
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -3,7 +3,7 @@
*
* Copyright (C) 2004-5 Patrick Boettcher (patrick.boettcher@desy.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -7,7 +7,7 @@
* based on GPL code from DiBcom, which has
* Copyright (C) 2004 Amaury Demol for DiBcom
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -3,7 +3,7 @@
*
* Copyright (C) 2004-5 Patrick Boettcher (patrick.boettcher@posteo.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_DIBUSB_H_
#define _DVB_USB_DIBUSB_H_

View File

@ -6,7 +6,7 @@
*
* partly based on the SDK published by Nebula Electronics
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "digitv.h"

View File

@ -4,7 +4,7 @@
*
* Copyright (C) 2005 Patrick Boettcher <patrick.boettcher@posteo.de>
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dtt200u.h"

View File

@ -6,7 +6,7 @@
*
* Thanks to Steve Chang from WideView for providing support for the WT-220U.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dtt200u.h"

View File

@ -4,7 +4,7 @@
*
* Copyright (C) 2004-5 Patrick Boettcher (patrick.boettcher@posteo.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_DTT200U_H_
#define _DVB_USB_DTT200U_H_

View File

@ -6,7 +6,7 @@
*
* Copyright (C) 2004-6 Patrick Boettcher (patrick.boettcher@posteo.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dvb-usb-common.h"

View File

@ -8,7 +8,7 @@
* Terratec Cinergy S2 cards
* Copyright (C) 2008-2012 Igor M. Liplianin (liplianin@me.by)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include <media/dvb-usb-ids.h>
#include "dw2102.h"

View File

@ -9,7 +9,7 @@
*
* This module is based off the vp7045 and vp702x modules
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "gp8psk.h"
#include "gp8psk-fe.h"

View File

@ -9,7 +9,7 @@
*
* This module is based off the vp7045 and vp702x modules
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_GP8PSK_H_
#define _DVB_USB_GP8PSK_H_

View File

@ -3,7 +3,7 @@
*
* Copyright (C) 2006 Aapo Tahkola (aet@rasterburn.org)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "m920x.h"

View File

@ -4,7 +4,7 @@
*
* Copyright (C) 2004-5 Patrick Boettcher (patrick.boettcher@posteo.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -4,7 +4,7 @@
* Copyright (C) 2006 Mario Hlawitschka (dh1pa@amsat.org)
* Copyright (C) 2006 Marco Gittler (g.marco@freenet.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#define DVB_USB_LOG_PREFIX "opera"

View File

@ -17,7 +17,7 @@
* Copyright (c) 2003 Felix Domke <tmbinc@elitedvb.net>
* Copyright (C) 2005-6 Patrick Boettcher <pb@linuxtv.org>
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#define DVB_USB_LOG_PREFIX "ttusb2"
#include "dvb-usb.h"

View File

@ -6,7 +6,7 @@
* Copyright (c) 2003 Felix Domke <tmbinc@elitedvb.net>
* Copyright (C) 2005-6 Patrick Boettcher <pb@linuxtv.de>
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_TTUSB2_H_
#define _DVB_USB_TTUSB2_H_

View File

@ -4,7 +4,7 @@
*
* Copyright (C) 2004-5 Patrick Boettcher (patrick.boettcher@posteo.de)
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "dibusb.h"

View File

@ -12,7 +12,7 @@
* This file can be removed soon, after the DST-driver is rewritten to provice
* the frontend-controlling separately.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "vp702x.h"

View File

@ -9,7 +9,7 @@
*
* Thanks to Twinhan who kindly provided hardware and information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "vp702x.h"
#include <linux/mutex.h>

View File

@ -6,7 +6,7 @@
*
* Thanks to Twinhan who kindly provided hardware and information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "vp7045.h"

View File

@ -7,7 +7,7 @@
*
* Thanks to Twinhan who kindly provided hardware and information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#include "vp7045.h"

View File

@ -6,7 +6,7 @@
*
* Thanks to Twinhan who kindly provided hardware and information.
*
* see Documentation/media/dvb-drivers/dvb-usb.rst for more information
* see Documentation/driver-api/media/drivers/dvb-usb.rst for more information
*/
#ifndef _DVB_USB_VP7045_H_
#define _DVB_USB_VP7045_H_