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

[Matteo Croce <technoboy85@gmail.com>]

Il giorno gio 9 apr 2026 alle ore 16:47 Joe Perches <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)

Regards,
-- 
Matteo Croce

perl -e 'for($t=0;;$t++){print chr($t*($t>>8|$t>>13)&255)}' |aplay