[PATCH v2 1/2] media: Fix building pdfdocs

Akira Yokosawa akiyks at gmail.com
Tue Mar 7 01:34:28 UTC 2023


From: Tomi Valkeinen <tomi.valkeinen at ideasonboard.com>

Commit 8d0e3fc61abd ("media: Add 2-10-10-10 RGB formats") added
documentation for a few new RGB formats. The table has column-width
specifiers for 34 columns used in pdfdocs build.

However, the new table has a couple of rows with 35 columns which
confused Sphinx's latex builder. The resulting .tex file causes
an error in a later stage of a pdfdocs build.

Remove the trailing empty dash lines to fix the issue.

Fixes: 8d0e3fc61abd ("media: Add 2-10-10-10 RGB formats")
Reported-by: Akira Yokosawa <akiyks at gmail.com>
Link: https://lore.kernel.org/r/12250823-8445-5854-dfb8-b92c0ff0851e@gmail.com/
Signed-off-by: Tomi Valkeinen <tomi.valkeinen at ideasonboard.com>
Tested-by: Akira Yokosawa <akiyks at gmail.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart+renesas at ideasonboard.com>
Acked-by: Mauro Carvalho Chehab <mchehab at kernel.org>
  [akiyks: explain the cause of build error]
Signed-off-by: Akira Yokosawa <akiyks at gmail.com>
---
Hi all,

Now that this fix missed v6.3-rc1, I went forward and amended the
Changelog to explain what was wrong in the offending commit.
I see that docs-next is ready for fixes to v6.3-rc1, but when the -media
tree gets ready, this can be picked by Mauro.
Either route is fine by me.
I'd really like to have this issue fixed sooner rather than later.

As a follow-up, patch 2/2 adjusts the column width specifiers.

        Thanks, Akira
--
v2: Changelog: explain the root cause,
    rebased on v6.3-rc1,
    picked tags from v1 thread.
v1: https://lore.kernel.org/r/20230208082916.68377-1-tomi.valkeinen@ideasonboard.com/

Documentation/userspace-api/media/v4l/pixfmt-rgb.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst b/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst
index d330aeb4d3eb..ea545ed1aeaa 100644
--- a/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst
+++ b/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst
@@ -868,7 +868,6 @@ number of bits for each component.
       - r\ :sub:`4`
       - r\ :sub:`3`
       - r\ :sub:`2`
-      -
     * .. _V4L2-PIX-FMT-RGBA1010102:
 
       - ``V4L2_PIX_FMT_RGBA1010102``
@@ -909,7 +908,6 @@ number of bits for each component.
       - r\ :sub:`4`
       - r\ :sub:`3`
       - r\ :sub:`2`
-      -
     * .. _V4L2-PIX-FMT-ARGB2101010:
 
       - ``V4L2_PIX_FMT_ARGB2101010``
@@ -950,7 +948,6 @@ number of bits for each component.
       - r\ :sub:`6`
       - r\ :sub:`5`
       - r\ :sub:`4`
-      -
 
 .. raw:: latex
 

base-commit: fe15c26ee26efa11741a7b632e9f23b01aca4cc6
-- 
2.25.1



More information about the dri-devel mailing list