[PATCH v2 0/1] fixes for maintainers_include

[PATCH v2 0/1] fixes for maintainers_include

[Mauro Carvalho Chehab]

Hi Jon,

This v2 replaces v1 series:
	[PATCH 0/2] A couple of fixes for maintainers_include.py

It basically fixes an issue reported by Manuel that entries
are printed duplicated.

In reality, the output maintainer entries are not properly
named per subsystem, so they appear to be duplicated.

Fixing the name output solves the issue and keeps the list
alphabetically sorted, as expected.

Mauro Carvalho Chehab (1):
  docs: maintainers_include: fix entry names

 Documentation/sphinx/maintainers_include.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

-- 
2.55.0

[PATCH v2 1/1] docs: maintainers_include: fix entry names

[Mauro Carvalho Chehab]

Right now, it is printing duplicated values as profile entries, as
it is not properly handling subsystem name.

Fix it.

Reported-by: Manuel Ebner <manuelebner@mailbox.org>
Closes: https://lore.kernel.org/linux-doc/98a558a87a07ab641f47c66c372ee7ed0735f4f5.camel@mailbox.org/
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
---
 Documentation/sphinx/maintainers_include.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Documentation/sphinx/maintainers_include.py b/Documentation/sphinx/maintainers_include.py
index dc9f9e188ffa..7ffe19b5ed58 100755
--- a/Documentation/sphinx/maintainers_include.py
+++ b/Documentation/sphinx/maintainers_include.py
@@ -161,7 +161,7 @@ class MaintainersParser:
                     html = KERNELDOC_URL + ename + ".html"
                     entries[entry] = f'`{ename} <{html}>`_'
                 else:
-                    entries[entry] = f':doc:`{ename} </{entry}>`'
+                    entries[entry] = f'/{entry}'
 
         return entries
 
@@ -345,7 +345,10 @@ class MaintainersProfile(Include):
                 output += f"- {name}: {entry}\n"
                 self.warning(f"{profile}: Invalid 'P' tag: {entry}\n")
             else:
-                output += f"- {entry}\n"
+                if not name:
+                    name = entry
+
+                output += f"- :doc:`{name} <{entry}>`\n"
 
         #
         # Create a hidden TOC table with all profiles. That allows adding
-- 
2.55.0