ARM: 9334/1: mm: init: remove misuse of kernel-doc comment

rddunlap · Russell King (Oracle) · commit 154c56d80b8f · 2024-02-24T16:47:18.000Z
Change the "/**" beginning of comment to the common "/*" comment
since the comment is not in kernel-doc format. This prevents a
kernel-doc warning:

arch/arm/mm/init.c:422: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 * update_sections_early intended to be called only through stop_machine

Signed-off-by: Randy Dunlap &lt;rdunlap@infradead.org&gt;
Cc: linux-arm-kernel@lists.infradead.org
Cc: patches@armlinux.org.uk
Signed-off-by: Russell King (Oracle) &lt;rmk+kernel@armlinux.org.uk&gt;
diff --git a/arch/arm/mm/init.c b/arch/arm/mm/init.c
@@ -418,7 +418,7 @@ static void set_section_perms(struct section_perm *perms, int n, bool set,
 
 }
 
-/**
+/*
  * update_sections_early intended to be called only through stop_machine
  * framework and executed by only one CPU while all other CPUs will spin and
  * wait, so no locking is required in this function.

Original file line number	Diff line number	Diff line change
`@@ -418,7 +418,7 @@ static void set_section_perms(struct section_perm *perms, int n, bool set,`
`418`	`418`
`419`	`419`	`}`
`420`	`420`
`421`		`-/**`
	`421`	`+/*`
`422`	`422`	`* update_sections_early intended to be called only through stop_machine`
`423`	`423`	`* framework and executed by only one CPU while all other CPUs will spin and`
`424`	`424`	`* wait, so no locking is required in this function.`