OSDN Git Service

[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 f37fc3b..05d86b2 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``