[PATCH] docs: media: Fix imbalance of LaTeX group

[PATCH] docs: media: Fix imbalance of LaTeX group

[Akira Yokosawa]

The beginning part of the "existing HSV/HSL formats" table (line 7742)
reads:

  .. raw:: latex

      \begingroup
      \tiny
      \setlength{\tabcolsep}{2pt}

However, the ending part (line 7834) reads:

  .. raw:: latex

      \normalsize


Fix the imbalance by replacing the \normalsize with \endgroup.

Note:
    Actually, the imbalance is harmless and just results in an
    informative message near the bottom of userspace-api.log:

      (\end occurred inside a group at level 1)

      ### semi simple group (level 1) entered at line 70696 (\begingroup)
      ### bottom level 

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Cc: Mauro Carvalho Chehab <mchehab@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
---
Hi,

This imbalance has existed ever since commit 70b074df4ed1 ("media:
fix pdf build with Spinx 1.6") authored by Mauro.
As it has no visible effect in the generated PDF, I'm not putting
a Fixes: tag.

Mauro, are you OK with this fix going through the -doc tree?
Otherwise, feel free to carry it through the -media tree.
Either is fine by me.

        Thanks, Akira
--
 Documentation/userspace-api/media/v4l/subdev-formats.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/userspace-api/media/v4l/subdev-formats.rst b/Documentation/userspace-api/media/v4l/subdev-formats.rst
index bd68588b2683..0cbc045d5df6 100644
--- a/Documentation/userspace-api/media/v4l/subdev-formats.rst
+++ b/Documentation/userspace-api/media/v4l/subdev-formats.rst
@@ -7833,7 +7833,7 @@ The following table lists existing HSV/HSL formats.
 
 .. raw:: latex
 
-    \normalsize
+    \endgroup
 
 
 JPEG Compressed Formats

base-commit: 065db2d90c6b8384c9072fe55f01c3eeda16c3c0
-- 
2.17.1

Re: [PATCH] docs: media: Fix imbalance of LaTeX group

[Mauro Carvalho Chehab]

Em Sat, 4 Dec 2021 12:37:35 +0900
Akira Yokosawa <akiyks@gmail.com> escreveu:

> The beginning part of the "existing HSV/HSL formats" table (line 7742)
> reads:
> 
>   .. raw:: latex
> 
>       \begingroup
>       \tiny
>       \setlength{\tabcolsep}{2pt}
> 
> However, the ending part (line 7834) reads:
> 
>   .. raw:: latex
> 
>       \normalsize
> 
> 
> Fix the imbalance by replacing the \normalsize with \endgroup.
> 
> Note:
>     Actually, the imbalance is harmless and just results in an
>     informative message near the bottom of userspace-api.log:
> 
>       (\end occurred inside a group at level 1)
> 
>       ### semi simple group (level 1) entered at line 70696 (\begingroup)
>       ### bottom level 
> 
> Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
> Cc: Mauro Carvalho Chehab <mchehab@kernel.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
> ---
> Hi,
> 
> This imbalance has existed ever since commit 70b074df4ed1 ("media:
> fix pdf build with Spinx 1.6") authored by Mauro.
> As it has no visible effect in the generated PDF, I'm not putting
> a Fixes: tag.
> 
> Mauro, are you OK with this fix going through the -doc tree?
> Otherwise, feel free to carry it through the -media tree.
> Either is fine by me.

I'm picking this one. It is usually easier this way, as it avoids the
risk of merge conflicts, as we update media API documentation together
with any patches touching the API itself.

Regards,
Mauro

> 
>         Thanks, Akira
> --
>  Documentation/userspace-api/media/v4l/subdev-formats.rst | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/Documentation/userspace-api/media/v4l/subdev-formats.rst b/Documentation/userspace-api/media/v4l/subdev-formats.rst
> index bd68588b2683..0cbc045d5df6 100644
> --- a/Documentation/userspace-api/media/v4l/subdev-formats.rst
> +++ b/Documentation/userspace-api/media/v4l/subdev-formats.rst
> @@ -7833,7 +7833,7 @@ The following table lists existing HSV/HSL formats.
>  
>  .. raw:: latex
>  
> -    \normalsize
> +    \endgroup
>  
>  
>  JPEG Compressed Formats
> 
> base-commit: 065db2d90c6b8384c9072fe55f01c3eeda16c3c0



Thanks,
Mauro