summaryrefslogtreecommitdiffstats
path: root/scripts/kernel-doc
diff options
context:
space:
mode:
authorJonathan Neuschäfer <j.neuschaefer@gmx.net>2023-01-29 16:04:35 +0100
committerJonathan Corbet <corbet@lwn.net>2023-01-31 21:55:44 +0100
commit3bdd9f075f54fea81572ef4d6f4edaef0027b5bc (patch)
treeb148fa15c2e063b4978256af851cef3b1913ba59 /scripts/kernel-doc
parentDocumentation: coccinelle: Escape --options to fix Sphinx output (diff)
downloadlinux-3bdd9f075f54fea81572ef4d6f4edaef0027b5bc.tar.xz
linux-3bdd9f075f54fea81572ef4d6f4edaef0027b5bc.zip
scripts: kernel-doc: Remove workaround for @param... syntax
Commit 43756e347f21 ("scripts/kernel-doc: Add support for named variable macro arguments") improved how named variable macro arguments are handled, and changed how they are documented in kerneldoc comments from "@param...", to "@param", deprecating the old syntax. All users of the old syntax have since been converted, so this commit finally removes support for it. The output of "make htmldocs" is the same with and without this commit. Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net> Link: https://lore.kernel.org/r/20230129150435.1510400-1-j.neuschaefer@gmx.net Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'scripts/kernel-doc')
-rwxr-xr-xscripts/kernel-doc11
1 files changed, 0 insertions, 11 deletions
diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index 54b0893cae66..5cf38abdaf9d 100755
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -2079,17 +2079,6 @@ sub process_name($$) {
sub process_body($$) {
my $file = shift;
- # Until all named variable macro parameters are
- # documented using the bare name (`x`) rather than with
- # dots (`x...`), strip the dots:
- if ($section =~ /\w\.\.\.$/) {
- $section =~ s/\.\.\.$//;
-
- if ($verbose) {
- emit_warning("${file}:$.", "Variable macro arguments should be documented without dots\n");
- }
- }
-
if ($state == STATE_BODY_WITH_BLANK_LINE && /^\s*\*\s?\S/) {
dump_section($file, $section, $contents);
$section = $section_default;