[media] vidioc-querycap.rst: Better format tables on PDF output
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Tue, 16 Aug 2016 15:07:10 +0000 (12:07 -0300)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Mon, 22 Aug 2016 13:05:19 +0000 (10:05 -0300)
Both tables on this rst file were not shown right, as they miss
the proper tag (tabularcolumns) to specify the column widths
required for PDF and LaTeX output.

Also, the second table is too big to fit into one page. So,
it should use the longtable class to allow it to be split into
two pages.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Documentation/media/uapi/v4l/vidioc-querycap.rst

index f37fc3badcdf699b3207f8f8818259cdef3652c0..05d86b2b87dd63652d908bd65a39de3cf5f09a23 100644 (file)
@@ -43,11 +43,12 @@ specification the ioctl returns an ``EINVAL`` error code.
 
 .. _v4l2-capability:
 
+.. tabularcolumns:: |p{1.5cm}|p{2.5cm}|p{13cm}|
+
 .. flat-table:: struct v4l2_capability
     :header-rows:  0
     :stub-columns: 0
-    :widths:       1 1 2
-
+    :widths:       3 4 20
 
     -  .. row 1
 
@@ -121,7 +122,9 @@ specification the ioctl returns an ``EINVAL`` error code.
 
          ``__u32 version = KERNEL_VERSION(0, 8, 1);``
 
-         ``printf ("Version: %u.%u.%u\\n", (version >> 16) & 0xFF, (version >> 8) & 0xFF, version & 0xFF);``
+         ``printf ("Version: %u.%u.%u\\n",``
+
+         ``(version >> 16) & 0xFF, (version >> 8) & 0xFF, version & 0xFF);``
 
     -  .. row 6
 
@@ -169,12 +172,15 @@ specification the ioctl returns an ``EINVAL`` error code.
 
 .. _device-capabilities:
 
+.. tabularcolumns:: |p{6cm}|p{2.2cm}|p{8.8cm}|
+
+.. cssclass:: longtable
+
 .. flat-table:: Device Capabilities Flags
     :header-rows:  0
     :stub-columns: 0
     :widths:       3 1 4
 
-
     -  .. row 1
 
        -  ``V4L2_CAP_VIDEO_CAPTURE``