Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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>

authored by

Jonathan Neuschäfer and committed by
Jonathan Corbet
3bdd9f07 19a12613

-11
-11
scripts/kernel-doc
··· 2079 2079 sub process_body($$) { 2080 2080 my $file = shift; 2081 2081 2082 - # Until all named variable macro parameters are 2083 - # documented using the bare name (`x`) rather than with 2084 - # dots (`x...`), strip the dots: 2085 - if ($section =~ /\w\.\.\.$/) { 2086 - $section =~ s/\.\.\.$//; 2087 - 2088 - if ($verbose) { 2089 - emit_warning("${file}:$.", "Variable macro arguments should be documented without dots\n"); 2090 - } 2091 - } 2092 - 2093 2082 if ($state == STATE_BODY_WITH_BLANK_LINE && /^\s*\*\s?\S/) { 2094 2083 dump_section($file, $section, $contents); 2095 2084 $section = $section_default;