bybrooklyn/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-04-18 14:53:58 -04:00
Code Issues Packages Projects Releases Wiki Activity

docs: kdoc_output: don't use a different modulename for functions

Browse Source 
It doesn't make much sense to have a different modulename just
for functions, but not for structs/enums/...

Use the same header everywere.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <978259bdf3e8d310c646ecf76ce56d054f6d5738.1772810752.git.mchehab+huawei@kernel.org>
This commit is contained in:
Mauro Carvalho Chehab
2026-03-06 16:45:44 +01:00
committed by Jonathan Corbet
parent 31938f120f
commit 1a63342a27
1 changed files with 3 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
tools/lib/python/kdoc/kdoc_output.py
View File

@@ -607,14 +607,11 @@ class ManFormat(OutputFormat):
"%m %d %Y",
]
def emit_th(self, name, modulename = None):
def emit_th(self, name):
"""Emit a title header line."""
name = name.strip()
if not modulename:
modulename = self.modulename
self.data += f'.TH "{modulename}" {self.section} "{name}" '
self.data += f'.TH "{self.modulename}" {self.section} "{name}" '
self.data += f'"{self.date}" "{self.manual}"\n'
def __init__(self, modulename, section="9", manual="Kernel API Manual"):
@@ -748,7 +745,7 @@ class ManFormat(OutputFormat):
out_name = self.arg_name(args, name)
self.emit_th(out_name, modulename = name)
self.emit_th(out_name)
self.data += ".SH NAME\n"
self.data += f"{name} \\- {args['purpose']}\n"