Re: [PATCH] MAINTAINERS: fix '*' wildcard formatting
From: Jonathan Corbet
Date: Wed Mar 04 2026 - 17:50:20 EST
Randy Dunlap <rdunlap@xxxxxxxxxxxxx> writes:
> It seems that these wildcards confuse some parser (docutils, sphinx,
> or maintainers_include.py), so quote them to avoid this issue.
> Also insert a hyphen ('-') before "all files" in several places
> to make the html output easier to read.
>
> Fixes this htmldocs warning:
>
> linux-next-20260304/MAINTAINERS:40: WARNING: Inline strong start-string without end-string. [docutils]
>
> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> ---
> Cc: Jonathan Corbet <corbet@xxxxxxx>
> Cc: Shuah Khan <skhan@xxxxxxxxxxxxxxxxxxx>
> Cc: linux-doc@xxxxxxxxxxxxxxx
> Cc: Kees Cook <kees@xxxxxxxxxx>
>
> MAINTAINERS | 10 +++++-----
> 1 file changed, 5 insertions(+), 5 deletions(-)
I remain unconvinced that dragging all of MAINTAINERS into the docs
build brings any joy. Is that something that you actually use?
(That said, as long as we're doing it, it should work properly)
Thanks,
jon