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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20211206132438.206f2474@coco.lan>
Date:   Mon, 6 Dec 2021 13:24:38 +0100
From:   Mauro Carvalho Chehab <mchehab@...nel.org>
To:     Akira Yokosawa <akiyks@...il.com>
Cc:     Jonathan Corbet <corbet@....net>, linux-media@...r.kernel.org,
        linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] docs: media: Fix imbalance of LaTeX group

Em Sat, 4 Dec 2021 12:37:35 +0900
Akira Yokosawa <akiyks@...il.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@...il.com>
> Cc: Mauro Carvalho Chehab <mchehab@...nel.org>
> Cc: Jonathan Corbet <corbet@....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