2024-01-08 00:37:14

by Randy Dunlap

Subject: [PATCH] kernel-doc: drop looking for "MACDOC"

Linux kernel does not use "MACDOC" in any documenation or any
source files, so stop searching for it.

Signed-off-by: Randy Dunlap <[email protected]>
Cc: Jonathan Corbet <[email protected]>
Cc: [email protected]
---
scripts/kernel-doc | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff -- a/scripts/kernel-doc b/scripts/kernel-doc
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -1907,7 +1907,7 @@ sub process_proto_function($$) {

$x =~ s@\/\/.*$@@gos; # strip C99-style comments to end of line

- if ($x =~ m#\s*/\*\s+MACDOC\s*#io || ($x =~ /^#/ && $x !~ /^#\s*define/)) {
+ if ($x =~ /^#/ && $x !~ /^#\s*define/) {
# do nothing
}
elsif ($x =~ /([^\{]*)/) {

2024-01-30 20:20:45

by Jonathan Corbet

Subject: Re: [PATCH] kernel-doc: drop looking for "MACDOC"

Randy Dunlap <[email protected]> writes:

> Linux kernel does not use "MACDOC" in any documenation or any
> source files, so stop searching for it.
>
> Signed-off-by: Randy Dunlap <[email protected]>
> Cc: Jonathan Corbet <[email protected]>
> Cc: [email protected]
> ---
> scripts/kernel-doc | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff -- a/scripts/kernel-doc b/scripts/kernel-doc
> --- a/scripts/kernel-doc
> +++ b/scripts/kernel-doc
> @@ -1907,7 +1907,7 @@ sub process_proto_function($$) {
>
> $x =~ s@\/\/.*$@@gos; # strip C99-style comments to end of line
>
> - if ($x =~ m#\s*/\*\s+MACDOC\s*#io || ($x =~ /^#/ && $x !~ /^#\s*define/)) {
> + if ($x =~ /^#/ && $x !~ /^#\s*define/) {
> # do nothing
> }

Applied, thanks.

jon

2024-01-30 20:30:24

by Jonathan Corbet

Subject: Re: [PATCH] kernel-doc: drop looking for "MACDOC"

Randy Dunlap <[email protected]> writes:

> Linux kernel does not use "MACDOC" in any documenation or any
> source files, so stop searching for it.
>
> Signed-off-by: Randy Dunlap <[email protected]>
> Cc: Jonathan Corbet <[email protected]>
> Cc: [email protected]
> ---
> scripts/kernel-doc | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff -- a/scripts/kernel-doc b/scripts/kernel-doc
> --- a/scripts/kernel-doc
> +++ b/scripts/kernel-doc
> @@ -1907,7 +1907,7 @@ sub process_proto_function($$) {
>
> $x =~ s@\/\/.*$@@gos; # strip C99-style comments to end of line
>
> - if ($x =~ m#\s*/\*\s+MACDOC\s*#io || ($x =~ /^#/ && $x !~ /^#\s*define/)) {
> + if ($x =~ /^#/ && $x !~ /^#\s*define/) {
> # do nothing
> }

Applied, thanks.

jon