[media] Docbook: Fix documentation for media controller devnodes

The media-ctl userspace application assumes that all device nodes
are uniquelly defined via major,minor, just like v4l and fb.

That's ok for those types of devices, but, as we're adding support
for DVB at the API, what's written there at the DocBook is wrong.

So, fix it.

While here, fix the size of the reserved space inside the union,
with is 184, and not 180.

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>

diff --git a/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml b/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
index 116c301656e0bde1732c2e0dbe124cc68285ad8d..19ab836b2651e20a79c9761bf04b4ad1195be955 100644 (file)
--- a/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
+++ b/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
@@ -143,86 +143,14 @@
          <row>
            <entry></entry>
            <entry>struct</entry>
-           <entry><structfield>v4l</structfield></entry>
+           <entry><structfield>dev</structfield></entry>
            <entry></entry>
-           <entry>Valid for V4L sub-devices and nodes only.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>major</structfield></entry>
-           <entry>V4L device node major number. For V4L sub-devices with no
-           device node, set by the driver to 0.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>minor</structfield></entry>
-           <entry>V4L device node minor number. For V4L sub-devices with no
-           device node, set by the driver to 0.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry>struct</entry>
-           <entry><structfield>fb</structfield></entry>
-           <entry></entry>
-           <entry>Valid for frame buffer nodes only.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>major</structfield></entry>
-           <entry>Frame buffer device node major number.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>minor</structfield></entry>
-           <entry>Frame buffer device node minor number.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry>struct</entry>
-           <entry><structfield>alsa</structfield></entry>
-           <entry></entry>
-           <entry>Valid for ALSA devices only.</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>card</structfield></entry>
-           <entry>ALSA card number</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>device</structfield></entry>
-           <entry>ALSA device number</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry></entry>
-           <entry>__u32</entry>
-           <entry><structfield>subdevice</structfield></entry>
-           <entry>ALSA sub-device number</entry>
-         </row>
-         <row>
-           <entry></entry>
-           <entry>int</entry>
-           <entry><structfield>dvb</structfield></entry>
-           <entry></entry>
-           <entry>DVB card number</entry>
+           <entry>Valid for (sub-)devices that create devnodes.</entry>
          </row>
          <row>
            <entry></entry>
            <entry>__u8</entry>
-           <entry><structfield>raw</structfield>[180]</entry>
+           <entry><structfield>raw</structfield>[184]</entry>
            <entry></entry>
            <entry></entry>
          </row>

diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml
index ac0f8d9d2a4976a59f6c02b44de1b6859e768134..3a16ac1f67d030c2a9762cd72800f64439dc1e17 100644 (file)
--- a/Documentation/DocBook/media/v4l/v4l2.xml
+++ b/Documentation/DocBook/media/v4l/v4l2.xml
@@ -136,6 +136,7 @@ Remote Controller chapter.</contrib>
       <year>2012</year>
       <year>2013</year>
       <year>2014</year>
+      <year>2015</year>
       <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
 Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab,
        Pawel Osciak</holder>
@@ -151,6 +152,13 @@ structs, ioctls) must be noted in more detail in the history chapter
 (compat.xml), along with the possible impact on existing drivers and
 applications. -->
 
+      <revision>
+       <revnumber>3.21</revnumber>
+       <date>2015-02-13</date>
+       <authorinitials>mcc</authorinitials>
+       <revremark>Fix documentation for media controller device nodes.
+       </revremark>
+      </revision>
       <revision>
        <revnumber>3.19</revnumber>
        <date>2014-12-05</date>