scripts: kernel-doc: Remove workaround for @param... syntax
authorJonathan Neuschäfer <j.neuschaefer@gmx.net>
Sun, 29 Jan 2023 15:04:35 +0000 (16:04 +0100)
committerJonathan Corbet <corbet@lwn.net>
Tue, 31 Jan 2023 20:55:44 +0000 (13:55 -0700)
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>
scripts/kernel-doc

index 54b0893cae666f7875db1dd2d537fde1d11701d9..5cf38abdaf9da8c59504f438e40f9faee71cf9b1 100755 (executable)
@@ -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;