[media] doc-rst: reorganize the kAPI v4l2 chapters
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Fri, 22 Jul 2016 13:15:42 +0000 (10:15 -0300)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Sat, 23 Jul 2016 11:04:21 +0000 (08:04 -0300)
Reorganize the order of the document, putting the chapters
on a more logical order and renaming some sections.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
18 files changed:
Documentation/media/kapi/v4l2-common.rst [new file with mode: 0644]
Documentation/media/kapi/v4l2-controls.rst
Documentation/media/kapi/v4l2-core.rst
Documentation/media/kapi/v4l2-dev.rst
Documentation/media/kapi/v4l2-device.rst
Documentation/media/kapi/v4l2-dv-timings.rst
Documentation/media/kapi/v4l2-event.rst
Documentation/media/kapi/v4l2-fh.rst
Documentation/media/kapi/v4l2-flash-led-class.rst
Documentation/media/kapi/v4l2-intro.rst
Documentation/media/kapi/v4l2-mc.rst
Documentation/media/kapi/v4l2-mediabus.rst
Documentation/media/kapi/v4l2-mem2mem.rst
Documentation/media/kapi/v4l2-rect.rst
Documentation/media/kapi/v4l2-subdev.rst
Documentation/media/kapi/v4l2-tuner.rst
Documentation/media/kapi/v4l2-tveeprom.rst
Documentation/media/kapi/v4l2-videobuf2.rst

diff --git a/Documentation/media/kapi/v4l2-common.rst b/Documentation/media/kapi/v4l2-common.rst
new file mode 100644 (file)
index 0000000..d1ea1c9
--- /dev/null
@@ -0,0 +1,4 @@
+V4L2 common functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. kernel-doc:: include/media/v4l2-common.h
index 2d433305fd4ede3f01643e9b93bb0c2f91783791..07a179eeb2fb5f4c24466e2ceb3749a83ffce001 100644 (file)
@@ -808,7 +808,7 @@ 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
------------------
+v4l2_ctrl functions and data structures
+---------------------------------------
 
 .. kernel-doc:: include/media/v4l2-ctrls.h
index 6285c18978d13617a9ee696311b92d443e3c812a..e9677150ed99d45c8922801e37599e8a93133d32 100644 (file)
@@ -6,20 +6,21 @@ Video2Linux devices
 
     v4l2-intro
     v4l2-dev
-    v4l2-controls
     v4l2-device
     v4l2-fh
+    v4l2-subdev
+    v4l2-event
+    v4l2-controls
+    v4l2-videobuf
+    v4l2-videobuf2
     v4l2-clocks
     v4l2-dv-timings
-    v4l2-event
     v4l2-flash-led-class
     v4l2-mc
     v4l2-mediabus
     v4l2-mem2mem
     v4l2-of
     v4l2-rect
-    v4l2-subdev
     v4l2-tuner
+    v4l2-common
     v4l2-tveeprom
-    v4l2-videobuf2
-    v4l2-videobuf
index 306306d8a43db65d179f9326435f8237dea0655e..b03f9b33ad932097803fb5da5a6d883c18e1852b 100644 (file)
@@ -1,5 +1,5 @@
-Video device creation
-=====================
+Video device' s internal representation
+=======================================
 
 The actual device nodes in the ``/dev`` directory are created using the
 :c:type:`video_device` struct (``v4l2-dev.h``). This struct can either be
@@ -309,8 +309,8 @@ it has been initialized:
 This can be done from the release callback.
 
 
-video_device helper functions
------------------------------
+helper functions
+----------------
 
 There are a few useful helper functions:
 
@@ -357,7 +357,7 @@ The name is used as a hint by userspace tools such as udev. The function
 should be used where possible instead of accessing the video_device::num and
 video_device::minor fields.
 
-video_device kAPI
------------------
+video_device functions and data structures
+------------------------------------------
 
 .. kernel-doc:: include/media/v4l2-dev.h
index 8e275d0ff0f5087146973cfb36ff61dd9b00d02b..c9115bcd8a9d002a6c5bdb509e8901d9547b5c0e 100644 (file)
@@ -1,5 +1,5 @@
-V4L2 Device register logic
---------------------------
+V4L2 device instance
+--------------------
 
 Each device instance is represented by a struct :c:type:`v4l2_device`.
 Very simple devices can just allocate this struct, but most of the time you
@@ -138,7 +138,7 @@ Since the initial refcount is 1 you also need to call
 or in the ``remove()`` callback (for e.g. PCI devices), otherwise the refcount
 will never reach 0.
 
-V4L2 device kAPI
-^^^^^^^^^^^^^^^^
+v4l2_device functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-device.h
index 4b08a49c54a4c1f6c557c78704cc1e954e98efa3..55274329d229fbfec07e8f7f1fd623bd0be8c490 100644 (file)
@@ -1,4 +1,4 @@
-V4L2 DV Timings kAPI
-^^^^^^^^^^^^^^^^^^^^
+V4L2 DV Timings functions
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-dv-timings.h
index 0bab793eb8fc3330de6eb6bfaa27d09129c4168e..d81bbf23b6b18e62936f3b0f2338b139b8f81f95 100644 (file)
@@ -130,7 +130,8 @@ function with ``V4L2_DEVICE_NOTIFY_EVENT``. This allows the bridge to map
 the subdev that sends the event to the video node(s) associated with the
 subdev that need to be informed about such an event.
 
-V4L2 event kAPI
-^^^^^^^^^^^^^^^
+V4L2 event functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-event.h
+
index a212698d5725bb25e1923ece6c664317ab11a3aa..ef4ae046c0c59b6dd75ef46f104d5619f23a4186 100644 (file)
@@ -133,6 +133,7 @@ associated device node:
 - Same, but it calls v4l2_fh_is_singular with filp->private_data.
 
 
-V4L2 File Handler kAPI
-^^^^^^^^^^^^^^^^^^^^^^
+V4L2 fh functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 .. kernel-doc:: include/media/v4l2-fh.h
index 251ed6b3aab320e9dc1a126367d7d5822c63756f..20798bdac3872c0ebc0059e379a031716739b355 100644 (file)
@@ -1,4 +1,4 @@
-V4L2 Flash and LED class kAPI
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+V4L2 flash functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-flash-led-class.h
index 7f4f26e666a2c955629e2664a847450aa428e23c..e614d8d4ca1c4041963942fc5d08c1e1c311e12d 100644 (file)
@@ -1,10 +1,3 @@
-Overview of the V4L2 driver framework
-=====================================
-
-This text documents the various structures provided by the V4L2 framework and
-their relationships.
-
-
 Introduction
 ------------
 
@@ -39,8 +32,8 @@ source that is available in samples/v4l/. It is a skeleton driver for
 a PCI capture card, and demonstrates how to use the V4L2 driver
 framework. It can be used as a template for real PCI video capture driver.
 
-Structure of a driver
----------------------
+Structure of a V4L driver
+-------------------------
 
 All drivers have the following structure:
 
@@ -68,8 +61,8 @@ This is a rough schematic of how it all relates:
          \-filehandle instances
 
 
-Structure of the framework
---------------------------
+Structure of the V4L2 framework
+-------------------------------
 
 The framework closely resembles the driver structure: it has a v4l2_device
 struct for the device instance data, a v4l2_subdev struct to refer to
index c94ce0fa38398327f02bc91ae7a51551d5585bca..8af3470134906e345f7279c26e5c9feac5ac5199 100644 (file)
@@ -1,4 +1,4 @@
-V4L2 Media Controller kAPI
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+V4L2 Media Controller functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-mc.h
index b3c246b51c2cccb369a004d108e14a4bbcd0d4f8..e64131906d11711fe0c27bf6d3657bad5bdd5473 100644 (file)
@@ -1,4 +1,4 @@
-V4L2 Media Bus kAPI
-^^^^^^^^^^^^^^^^^^^
+V4L2 Media Bus functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-mediabus.h
index 61f9923286c7c6fb44b332f5d31fcee35bd5ecc2..5536b4a71e5103f558f253b2a836467e1d0c746f 100644 (file)
@@ -1,3 +1,4 @@
-V4L2 Memory to Memory kAPI
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+V4L2 Memory to Memory functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 .. kernel-doc:: include/media/v4l2-mem2mem.h
index bb86dcbc5a3c628ba6f4c950bfa0bcdb3ff29c8c..8df5067ad57dced4a799686fe1160d3855757769 100644 (file)
@@ -1,4 +1,4 @@
-V4L2 rect kAPI
-^^^^^^^^^^^^^^
+V4L2 rect helper functions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/v4l2-rect.h
index 456fdec6904234220e5dff66b6511e37811b36ba..7e45b23ad3bde8f42042afaebb7233970c46fdb3 100644 (file)
@@ -440,18 +440,6 @@ well, but with irq set to 0 and platform_data set to ``NULL``.
 V4L2 sub-device functions and data structures
 ---------------------------------------------
 
-V4L2 sub-device kAPI
-^^^^^^^^^^^^^^^^^^^^
-
 .. kernel-doc:: include/media/v4l2-subdev.h
 
-V4L2 sub-device asynchronous kAPI
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
 .. kernel-doc:: include/media/v4l2-async.h
-
-
-V4L2 common kAPI
-^^^^^^^^^^^^^^^^
-
-.. kernel-doc:: include/media/v4l2-common.h
index 37b0ef310a62bb746eb812da396c5c7daec054f3..86e89463965142b85423bb46cb0b6e36ed9298c2 100644 (file)
@@ -1,5 +1,5 @@
-Tuner kAPI
-^^^^^^^^^^
+Tuner functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/tuner.h
 
index f7ef71742e93a2431907c92610030667173a34f3..33422cb26aa716b676ba0c20e94f5f85d2f28ec7 100644 (file)
@@ -1,4 +1,4 @@
-Hauppauge TV EEPROM kAPI
-^^^^^^^^^^^^^^^^^^^^^^^^
+Hauppauge TV EEPROM functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/tveeprom.h
index bdb8b83f1ea0789b5196eb9b5469b470a9106e5a..3c4cb1e7e05f29b3aae5f13750cfa3c46a67f2b5 100644 (file)
@@ -1,7 +1,7 @@
 .. _vb2_framework:
 
-V4L2 videobuf2 kAPI
-^^^^^^^^^^^^^^^^^^^
+V4L2 videobuf2 functions and data structures
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. kernel-doc:: include/media/videobuf2-core.h