[media] V4L: docbook documentation for struct v4l2_create_buffers

Signed-off-by: Guennadi Liakhovetski <g.liakhovetski@gmx.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

diff --git a/drivers/media/video/v4l2-compat-ioctl32.c b/drivers/media/video/v4l2-compat-ioctl32.c
index e77e0cfc931229a54df32cbd221ddb4e492f85e4..c68531b882794d46abfa260f378b1f4b3ec9f9c7 100644 (file)
--- a/drivers/media/video/v4l2-compat-ioctl32.c
+++ b/drivers/media/video/v4l2-compat-ioctl32.c
@@ -159,11 +159,20 @@ struct v4l2_format32 {
        } fmt;
 };
 
+/**
+ * struct v4l2_create_buffers32 - VIDIOC_CREATE_BUFS32 argument
+ * @index:     on return, index of the first created buffer
+ * @count:     entry: number of requested buffers,
+ *             return: number of created buffers
+ * @memory:    buffer memory type
+ * @format:    frame format, for which buffers are requested
+ * @reserved:  future extensions
+ */
 struct v4l2_create_buffers32 {
-       __u32                   index;          /* output: buffers index...index + count - 1 have been created */
+       __u32                   index;
        __u32                   count;
        enum v4l2_memory        memory;
-       struct v4l2_format32    format;         /* filled in by the user, plane sizes calculated by the driver */
+       struct v4l2_format32    format;
        __u32                   reserved[8];
 };
 

diff --git a/include/linux/videodev2.h b/include/linux/videodev2.h
index cd512f07beed7d1ca2a32bee9f5fc65df6bbba9b..66945a6f628de604d8aad971a40abb305dfb7acf 100644 (file)
--- a/include/linux/videodev2.h
+++ b/include/linux/videodev2.h
@@ -2142,12 +2142,20 @@ struct v4l2_dbg_chip_ident {
        __u32 revision;    /* chip revision, chip specific */
 } __attribute__ ((packed));
 
-/* VIDIOC_CREATE_BUFS */
+/**
+ * struct v4l2_create_buffers - VIDIOC_CREATE_BUFS argument
+ * @index:     on return, index of the first created buffer
+ * @count:     entry: number of requested buffers,
+ *             return: number of created buffers
+ * @memory:    buffer memory type
+ * @format:    frame format, for which buffers are requested
+ * @reserved:  future extensions
+ */
 struct v4l2_create_buffers {
-       __u32                   index;          /* output: buffers index...index + count - 1 have been created */
+       __u32                   index;
        __u32                   count;
        enum v4l2_memory        memory;
-       struct v4l2_format      format;         /* "type" is used always, the rest if sizeimage == 0 */
+       struct v4l2_format      format;
        __u32                   reserved[8];
 };