[PATCH] fixp-arith: convert comments to kernel-doc format

Randy Dunlap posted 1 patch 2 months ago
include/linux/fixp-arith.h |    4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
[PATCH] fixp-arith: convert comments to kernel-doc format
Posted by Randy Dunlap 2 months ago
Insert a hyphen ('-') in 2 places to prevent kernel-doc warnings:

Warning: include/linux/fixp-arith.h:42 This comment starts with '/**',
 but isn't a kernel-doc comment.
 * __fixp_sin32() returns the sin of an angle in degrees
Warning: include/linux/fixp-arith.h:66 This comment starts with '/**',
 but isn't a kernel-doc comment.
 * fixp_sin32() returns the sin of an angle in degrees

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Jonathan Cameron <jic23@kernel.org>
Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com>

 include/linux/fixp-arith.h |    4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

--- linux-next-20260729.orig/include/linux/fixp-arith.h
+++ linux-next-20260729/include/linux/fixp-arith.h
@@ -40,7 +40,7 @@ static const s32 sin_table[] = {
 };
 
 /**
- * __fixp_sin32() returns the sin of an angle in degrees
+ * __fixp_sin32() - returns the sin of an angle in degrees
  *
  * @degrees: angle, in degrees, from 0 to 360.
  *
@@ -64,7 +64,7 @@ static inline s32 __fixp_sin32(int degre
 }
 
 /**
- * fixp_sin32() returns the sin of an angle in degrees
+ * fixp_sin32() - returns the sin of an angle in degrees
  *
  * @degrees: angle, in degrees. The angle can be positive or negative
  *
Re: [PATCH] fixp-arith: convert comments to kernel-doc format
Posted by Dmitry Torokhov 2 months ago
On Thu, Jul 30, 2026 at 10:06:25PM -0700, Randy Dunlap wrote:
> Insert a hyphen ('-') in 2 places to prevent kernel-doc warnings:
> 
> Warning: include/linux/fixp-arith.h:42 This comment starts with '/**',
>  but isn't a kernel-doc comment.
>  * __fixp_sin32() returns the sin of an angle in degrees
> Warning: include/linux/fixp-arith.h:66 This comment starts with '/**',
>  but isn't a kernel-doc comment.
>  * fixp_sin32() returns the sin of an angle in degrees
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Applied, thank you.

-- 
Dmitry