Re: [linux-next:master 8662/12838] htmldocs: MAINTAINERS:40: WARNING: Inline strong start-string without end-string. [docutils]

[Joe Perches <joe@perches.com>]

On Thu, 2026-04-09 at 18:16 +0200, Matteo Croce wrote:
> ```
> Il giorno gio 9 apr 2026 alle ore 16:47 Joe Perches <[joe@perches.com](mailto:joe@perches.com)>
> ha scritto:
> > On Thu, 2026-04-09 at 12:12 +0200, Matteo Croce wrote:
> MAINTAINERS:40: WARNING: Inline strong start-string without end-string. [docutils]
> > > >    Documentation/userspace-api/landlock:480: ./security/landlock/errata/abi-4.h:5: ERROR: Unexpected section title.
> > > The problem is that "**" is seen as start of a bold text in RST.
> > > Escaping the first * fixes error and keeps the glob unaffected:
> > > 
> > > --- a/MAINTAINERS
> > > +++ b/MAINTAINERS
> > > @@ -35,7 +35,7 @@ Descriptions of section entries and preferred order
> > >      F: drivers/net/ all files in and below drivers/net
> > >      F: drivers/net/* all files in drivers/net, but not below
> > >      F: */net/* all files in "any top level directory"/net
> > > -    F: fs/**/*foo*.c all *foo*.c files in any subdirectory of fs
> > > +    F: fs/\**/*foo*.c all *foo*.c files in any subdirectory of fs
> > >      One pattern per line.  Multiple F: lines acceptable.
> > >   X: *Excluded* files and directories that are NOT maintained, same
> > >      rules as F:. Files exclusions are tested before file matches.
> > > 
> > > should I create a fix patch or we can still amend the previous in net-next?
> > 
> > nack.
> > 
> > this shouldn't be fixed this way.
> > betterwould be to not try to format things that shouldn't be formatted.
> 
> what about escaping it here?
> 
> --- a/Documentation/sphinx/maintainers_include.py
> +++ b/Documentation/sphinx/maintainers_include.py
> @@ -89,7 +89,8 @@ class MaintainersInclude(Include):
>              output = None
>              if descriptions:
>                  # Escape the escapes in preformatted text.
> -                output = "| %s" % (line.replace("\\", "\\\\"))
> +                output = "| %s" % (line.replace("\\", "\\\\")
> +                                        .replace("**", "\\**"))
>                  # Look for and record field letter to field name mappings:
>                  #   R: Designated *reviewer*: FullName <address@domain>
>                  m = re.search(r"\s(\S):\s", line)

I didn't know that file existed.  Fine by me as long as it works.