kernel-doc: drop looking for "MACDOC"

Message ID 20240108003700.13418-1-rdunlap@infradead.org
State New
Headers
Series kernel-doc: drop looking for "MACDOC" |

Commit Message

Randy Dunlap Jan. 8, 2024, 12:37 a.m. UTC
  Linux kernel does not use "MACDOC" in any documenation or any
source files, so stop searching for it.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
---
 scripts/kernel-doc |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
  

Comments

Jonathan Corbet Jan. 30, 2024, 8:19 p.m. UTC | #1
Randy Dunlap <rdunlap@infradead.org> writes:

> Linux kernel does not use "MACDOC" in any documenation or any
> source files, so stop searching for it.
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: linux-doc@vger.kernel.org
> ---
>  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
  
Jonathan Corbet Jan. 30, 2024, 8:29 p.m. UTC | #2
Randy Dunlap <rdunlap@infradead.org> writes:

> Linux kernel does not use "MACDOC" in any documenation or any
> source files, so stop searching for it.
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: linux-doc@vger.kernel.org
> ---
>  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
  

Patch

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 =~ /([^\{]*)/) {