Re: [PATCH] MAINTAINERS: fix '*' wildcard formatting

From: Randy Dunlap

Date: Wed Mar 04 2026 - 19:24:47 EST




On 3/4/26 2:50 PM, Jonathan Corbet wrote:
> 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?

No, I use '$editor MAINTAINERS'.
I'm quite good with rm Documentation/sphinx/maintainers_include.py.

> (That said, as long as we're doing it, it should work properly)
Yeah, just make the warning go away.

--
~Randy