[PATCH 2/2] Documentation: Remove deprecated kernel-doc option 'functions'

From: Anna-Maria Behnsen
Date: Mon Jan 22 2024 - 08:29:06 EST


As there are no more users of deprecated kernel-doc option 'functions', remove
the related parts in documentation and scripts.

Signed-off-by: Anna-Maria Behnsen <anna-maria@xxxxxxxxxxxxx>
---
Documentation/doc-guide/kernel-doc.rst | 3 ---
Documentation/sphinx/kerneldoc.py | 5 -----
2 files changed, 8 deletions(-)

diff --git a/Documentation/doc-guide/kernel-doc.rst b/Documentation/doc-guide/kernel-doc.rst
index 6ad72ac6861b..74d6408abcd3 100644
--- a/Documentation/doc-guide/kernel-doc.rst
+++ b/Documentation/doc-guide/kernel-doc.rst
@@ -505,9 +505,6 @@ no-identifiers: *[ function/type ...]*
.. kernel-doc:: lib/bitmap.c
:no-identifiers: bitmap_parselist

-functions: *[ function/type ...]*
- This is an alias of the 'identifiers' directive and deprecated.
-
doc: *title*
Include documentation for the ``DOC:`` paragraph identified by *title* in
*source*. Spaces are allowed in *title*; do not quote the *title*. The *title*
diff --git a/Documentation/sphinx/kerneldoc.py b/Documentation/sphinx/kerneldoc.py
index 7acf09963daa..2d57c464c76a 100644
--- a/Documentation/sphinx/kerneldoc.py
+++ b/Documentation/sphinx/kerneldoc.py
@@ -53,7 +53,6 @@ class KernelDocDirective(Directive):
'internal': directives.unchanged,
'identifiers': directives.unchanged,
'no-identifiers': directives.unchanged,
- 'functions': directives.unchanged,
}
has_content = False

@@ -74,10 +73,6 @@ class KernelDocDirective(Directive):

tab_width = self.options.get('tab-width', self.state.document.settings.tab_width)

- # 'function' is an alias of 'identifiers'
- if 'functions' in self.options:
- self.options['identifiers'] = self.options.get('functions')
-
# FIXME: make this nicer and more robust against errors
if 'export' in self.options:
cmd += ['-export']
--
2.39.2