[PATCH v2 05/13] docs: kdoc_output: use a single manual for everything

From: Mauro Carvalho Chehab

Date: Fri Mar 06 2026 - 10:47:31 EST


There's no reason why functions will be on a different manual.
Unify its name, calling it as "Kernel API Manual".

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
---
tools/lib/python/kdoc/kdoc_output.py | 12 ++++--------
1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/tools/lib/python/kdoc/kdoc_output.py b/tools/lib/python/kdoc/kdoc_output.py
index d0b237c09391..24ee1fad681e 100644
--- a/tools/lib/python/kdoc/kdoc_output.py
+++ b/tools/lib/python/kdoc/kdoc_output.py
@@ -607,20 +607,17 @@ class ManFormat(OutputFormat):
"%m %d %Y",
]

- def emit_th(self, name, modulename = None, manual=None):
+ def emit_th(self, name, modulename = None):
"""Emit a title header line."""
name = name.strip()

- if not manual:
- manual = self.manual
-
if not modulename:
modulename = self.modulename

self.data += f'.TH "{modulename}" {self.section} "{name}" '
- self.data += f'"{self.date}" "{manual}"\n'
+ self.data += f'"{self.date}" "{self.manual}"\n'

- def __init__(self, modulename, section="9", manual="API Manual"):
+ def __init__(self, modulename, section="9", manual="Kernel API Manual"):
"""
Creates class variables.

@@ -751,8 +748,7 @@ class ManFormat(OutputFormat):

out_name = self.arg_name(args, name)

- self.emit_th(out_name, modulename = name,
- manual="Kernel Hacker\'s Manual")
+ self.emit_th(out_name, modulename = name)

self.data += ".SH NAME\n"
self.data += f"{name} \\- {args['purpose']}\n"
--
2.52.0