diff options
author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-20 17:14:37 (GMT) |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-23 11:03:24 (GMT) |
commit | 58759874002a71cbd48a01b615a210bb474e1f2b (patch) | |
tree | 0e3124169831770ce628e851cf8ad2b9e7d30c60 /Documentation/media/kapi | |
parent | 575f93084db35ced739a3df9ad398e46704c32c9 (diff) | |
download | linux-58759874002a71cbd48a01b615a210bb474e1f2b.tar.xz |
[media] doc-rst: Split v4l-core into one file per kAPI
Sphinx produce a 1:1 mapping between a rst file and an html file.
So, we need to split the kernel-doc tags on multiple documents.
A side effect is that we're now having a better name for each
section of the kAPI documentation.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'Documentation/media/kapi')
-rw-r--r-- | Documentation/media/kapi/v4l2-async.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-controls.rst | 5 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-core.rst | 55 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-device.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-dv-timings.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-event.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-flash-led-class.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-mc.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-mediabus.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-mem2mem.rst | 3 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-of.rst | 3 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-rect.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-subdev.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-tuner.rst | 6 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-tveeprom.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-videobuf.rst (renamed from Documentation/media/kapi/videobuf.rst) | 0 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-videobuf2.rst | 8 |
17 files changed, 85 insertions, 35 deletions
diff --git a/Documentation/media/kapi/v4l2-async.rst b/Documentation/media/kapi/v4l2-async.rst new file mode 100644 index 0000000..372aa29 --- /dev/null +++ b/Documentation/media/kapi/v4l2-async.rst @@ -0,0 +1,4 @@ +V4L2 Async kAPI +^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-async.h diff --git a/Documentation/media/kapi/v4l2-controls.rst b/Documentation/media/kapi/v4l2-controls.rst index 916fd43..2d43330 100644 --- a/Documentation/media/kapi/v4l2-controls.rst +++ b/Documentation/media/kapi/v4l2-controls.rst @@ -807,3 +807,8 @@ notify function is called. There can be only one notify function per control handler. Any attempt to set another notify function will cause a WARN_ON. + +V4L2 control kAPI +----------------- + +.. kernel-doc:: include/media/v4l2-ctrls.h diff --git a/Documentation/media/kapi/v4l2-core.rst b/Documentation/media/kapi/v4l2-core.rst index db571a4..8c127cc 100644 --- a/Documentation/media/kapi/v4l2-core.rst +++ b/Documentation/media/kapi/v4l2-core.rst @@ -1,38 +1,23 @@ Video2Linux devices ------------------- -.. kernel-doc:: include/media/tuner.h - -.. kernel-doc:: include/media/tuner-types.h - -.. kernel-doc:: include/media/tveeprom.h - -.. kernel-doc:: include/media/v4l2-async.h - -.. kernel-doc:: include/media/v4l2-ctrls.h - -.. kernel-doc:: include/media/v4l2-device.h - -.. kernel-doc:: include/media/v4l2-dv-timings.h - -.. kernel-doc:: include/media/v4l2-event.h - -.. kernel-doc:: include/media/v4l2-flash-led-class.h - -.. kernel-doc:: include/media/v4l2-mc.h - -.. kernel-doc:: include/media/v4l2-mediabus.h - -.. kernel-doc:: include/media/v4l2-mem2mem.h - -.. kernel-doc:: include/media/v4l2-of.h - -.. kernel-doc:: include/media/v4l2-rect.h - -.. kernel-doc:: include/media/v4l2-subdev.h - -.. kernel-doc:: include/media/videobuf2-core.h - -.. kernel-doc:: include/media/videobuf2-v4l2.h - -.. kernel-doc:: include/media/videobuf2-memops.h +.. toctree:: + :maxdepth: 1 + + v4l2-framework + v4l2-async + v4l2-controls + v4l2-device + v4l2-dv-timings + v4l2-event + v4l2-flash-led-class + v4l2-mc + v4l2-mediabus + v4l2-mem2mem + v4l2-of + v4l2-rect + v4l2-subdev + v4l2-tuner + v4l2-tveeprom + v4l2-videobuf2 + v4l2-videobuf diff --git a/Documentation/media/kapi/v4l2-device.rst b/Documentation/media/kapi/v4l2-device.rst new file mode 100644 index 0000000..e324fbc --- /dev/null +++ b/Documentation/media/kapi/v4l2-device.rst @@ -0,0 +1,4 @@ +V4L2 Device kAPI +^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-device.h diff --git a/Documentation/media/kapi/v4l2-dv-timings.rst b/Documentation/media/kapi/v4l2-dv-timings.rst new file mode 100644 index 0000000..4b08a49 --- /dev/null +++ b/Documentation/media/kapi/v4l2-dv-timings.rst @@ -0,0 +1,4 @@ +V4L2 DV Timings kAPI +^^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-dv-timings.h diff --git a/Documentation/media/kapi/v4l2-event.rst b/Documentation/media/kapi/v4l2-event.rst new file mode 100644 index 0000000..b54bd91 --- /dev/null +++ b/Documentation/media/kapi/v4l2-event.rst @@ -0,0 +1,4 @@ +V4L2 event kAPI +^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-event.h diff --git a/Documentation/media/kapi/v4l2-flash-led-class.rst b/Documentation/media/kapi/v4l2-flash-led-class.rst new file mode 100644 index 0000000..251ed6b --- /dev/null +++ b/Documentation/media/kapi/v4l2-flash-led-class.rst @@ -0,0 +1,4 @@ +V4L2 Flash and LED class kAPI +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-flash-led-class.h diff --git a/Documentation/media/kapi/v4l2-mc.rst b/Documentation/media/kapi/v4l2-mc.rst new file mode 100644 index 0000000..c94ce0f --- /dev/null +++ b/Documentation/media/kapi/v4l2-mc.rst @@ -0,0 +1,4 @@ +V4L2 Media Controller kAPI +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-mc.h diff --git a/Documentation/media/kapi/v4l2-mediabus.rst b/Documentation/media/kapi/v4l2-mediabus.rst new file mode 100644 index 0000000..b3c246b --- /dev/null +++ b/Documentation/media/kapi/v4l2-mediabus.rst @@ -0,0 +1,4 @@ +V4L2 Media Bus kAPI +^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-mediabus.h diff --git a/Documentation/media/kapi/v4l2-mem2mem.rst b/Documentation/media/kapi/v4l2-mem2mem.rst new file mode 100644 index 0000000..61f9923 --- /dev/null +++ b/Documentation/media/kapi/v4l2-mem2mem.rst @@ -0,0 +1,3 @@ +V4L2 Memory to Memory kAPI +^^^^^^^^^^^^^^^^^^^^^^^^^^ +.. kernel-doc:: include/media/v4l2-mem2mem.h diff --git a/Documentation/media/kapi/v4l2-of.rst b/Documentation/media/kapi/v4l2-of.rst new file mode 100644 index 0000000..1ddf76b --- /dev/null +++ b/Documentation/media/kapi/v4l2-of.rst @@ -0,0 +1,3 @@ +V4L2 Open Firmware kAPI +^^^^^^^^^^^^^^^^^^^^^^^ +.. kernel-doc:: include/media/v4l2-of.h diff --git a/Documentation/media/kapi/v4l2-rect.rst b/Documentation/media/kapi/v4l2-rect.rst new file mode 100644 index 0000000..bb86dcb --- /dev/null +++ b/Documentation/media/kapi/v4l2-rect.rst @@ -0,0 +1,4 @@ +V4L2 rect kAPI +^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-rect.h diff --git a/Documentation/media/kapi/v4l2-subdev.rst b/Documentation/media/kapi/v4l2-subdev.rst new file mode 100644 index 0000000..1b262aa --- /dev/null +++ b/Documentation/media/kapi/v4l2-subdev.rst @@ -0,0 +1,4 @@ +V4L2 subdev kAPI +^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-subdev.h diff --git a/Documentation/media/kapi/v4l2-tuner.rst b/Documentation/media/kapi/v4l2-tuner.rst new file mode 100644 index 0000000..37b0ef3 --- /dev/null +++ b/Documentation/media/kapi/v4l2-tuner.rst @@ -0,0 +1,6 @@ +Tuner kAPI +^^^^^^^^^^ + +.. kernel-doc:: include/media/tuner.h + +.. kernel-doc:: include/media/tuner-types.h diff --git a/Documentation/media/kapi/v4l2-tveeprom.rst b/Documentation/media/kapi/v4l2-tveeprom.rst new file mode 100644 index 0000000..f7ef717 --- /dev/null +++ b/Documentation/media/kapi/v4l2-tveeprom.rst @@ -0,0 +1,4 @@ +Hauppauge TV EEPROM kAPI +^^^^^^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/tveeprom.h diff --git a/Documentation/media/kapi/videobuf.rst b/Documentation/media/kapi/v4l2-videobuf.rst index 0115672..0115672 100644 --- a/Documentation/media/kapi/videobuf.rst +++ b/Documentation/media/kapi/v4l2-videobuf.rst diff --git a/Documentation/media/kapi/v4l2-videobuf2.rst b/Documentation/media/kapi/v4l2-videobuf2.rst new file mode 100644 index 0000000..b4f2d69 --- /dev/null +++ b/Documentation/media/kapi/v4l2-videobuf2.rst @@ -0,0 +1,8 @@ +V4L2 videobuf2 kAPI +^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/videobuf2-core.h + +.. kernel-doc:: include/media/videobuf2-v4l2.h + +.. kernel-doc:: include/media/videobuf2-memops.h |