[3/3] Removed extra asterisks from comment beginnings, and removed unnecessary comment end

Commit Message

Steven Davis July 7, 2024, 4:14 a.m. UTC

From 072a5624cf67614a7f64d6ba15773f85ee5a2e1d Mon Sep 17 00:00:00 2001
From: Steven Davis <[e-mail]>
Date: Wed, 3 Jul 2024 16:00:15 -0400
Subject: [PATCH 3/3] Removed, like, 30,000 more useless asterisks

Is there a reason for those extra asterisks to be in there? Seems unnecessary.
Signed-off-by: Steven Davis <[e-mail]>
---
 sound/sound_core.c | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

Comments

Randy Dunlap July 7, 2024, 4:51 a.m. UTC | #1

On 7/6/24 9:14 PM, Gold Side wrote:
> From 072a5624cf67614a7f64d6ba15773f85ee5a2e1d Mon Sep 17 00:00:00 2001
> From: Steven Davis <[e-mail]>
> Date: Wed, 3 Jul 2024 16:00:15 -0400
> Subject: [PATCH 3/3] Removed, like, 30,000 more useless asterisks
> 
> Is there a reason for those extra asterisks to be in there? Seems unnecessary.

Yes, they are for kernel-doc comments, which aid in generating documentation.
They are not unnecessary.

> Signed-off-by: Steven Davis <[e-mail]>
> ---
>  sound/sound_core.c | 12 ++++++------
>  1 file changed, 6 insertions(+), 6 deletions(-)
> 
> diff --git a/sound/sound_core.c b/sound/sound_core.c
> index d81fed1c122699..6d446c5bb94a0f 100644
> --- a/sound/sound_core.c
> +++ b/sound/sound_core.c
> @@ -331,7 +331,7 @@ static void sound_remove_unit(struct sound_unit **list, int unit)
>  
>  static struct sound_unit *chains[SOUND_STEP];
>  
> -/**
> +/*
>   *   register_sound_special_device - register a special sound node
>   *   @fops: File operations for the driver
>   *   @unit: Unit number to allocate
> @@ -418,7 +418,7 @@ int register_sound_special(const struct file_operations *fops, int unit)
>  
>  EXPORT_SYMBOL(register_sound_special);
>  
> -/**
> +/*
>   *   register_sound_mixer - register a mixer device
>   *   @fops: File operations for the driver
>   *   @dev: Unit number to allocate
> @@ -443,7 +443,7 @@ EXPORT_SYMBOL(register_sound_mixer);
>   *   in open - see below.
>   */
>   
> -/**
> +/*
>   *   register_sound_dsp - register a DSP device
>   *   @fops: File operations for the driver
>   *   @dev: Unit number to allocate
> @@ -466,7 +466,7 @@ int register_sound_dsp(const struct file_operations *fops, int dev)
>  
>  EXPORT_SYMBOL(register_sound_dsp);
>  
> -/**
> +/*
>   *   unregister_sound_special - unregister a special sound device
>   *   @unit: unit number to allocate
>   *
> @@ -483,7 +483,7 @@ void unregister_sound_special(int unit)
>   
>  EXPORT_SYMBOL(unregister_sound_special);
>  
> -/**
> +/*
>   *   unregister_sound_mixer - unregister a mixer
>   *   @unit: unit number to allocate
>   *
> @@ -498,7 +498,7 @@ void unregister_sound_mixer(int unit)
>  
>  EXPORT_SYMBOL(unregister_sound_mixer);
>  
> -/**
> +/*
>   *   unregister_sound_dsp - unregister a DSP device
>   *   @unit: unit number to allocate
>   *

Patch

diff --git a/sound/sound_core.c b/sound/sound_core.c
index d81fed1c122699..6d446c5bb94a0f 100644
--- a/sound/sound_core.c
+++ b/sound/sound_core.c
@@ -331,7 +331,7 @@  static void sound_remove_unit(struct sound_unit **list, int unit)
 
 static struct sound_unit *chains[SOUND_STEP];
 
-/**
+/*
  *   register_sound_special_device - register a special sound node
  *   @fops: File operations for the driver
  *   @unit: Unit number to allocate
@@ -418,7 +418,7 @@  int register_sound_special(const struct file_operations *fops, int unit)
 
 EXPORT_SYMBOL(register_sound_special);
 
-/**
+/*
  *   register_sound_mixer - register a mixer device
  *   @fops: File operations for the driver
  *   @dev: Unit number to allocate
@@ -443,7 +443,7 @@  EXPORT_SYMBOL(register_sound_mixer);
  *   in open - see below.
  */
  
-/**
+/*
  *   register_sound_dsp - register a DSP device
  *   @fops: File operations for the driver
  *   @dev: Unit number to allocate
@@ -466,7 +466,7 @@  int register_sound_dsp(const struct file_operations *fops, int dev)
 
 EXPORT_SYMBOL(register_sound_dsp);
 
-/**
+/*
  *   unregister_sound_special - unregister a special sound device
  *   @unit: unit number to allocate
  *
@@ -483,7 +483,7 @@  void unregister_sound_special(int unit)
  
 EXPORT_SYMBOL(unregister_sound_special);
 
-/**
+/*
  *   unregister_sound_mixer - unregister a mixer
  *   @unit: unit number to allocate
  *
@@ -498,7 +498,7 @@  void unregister_sound_mixer(int unit)
 
 EXPORT_SYMBOL(unregister_sound_mixer);
 
-/**
+/*
  *   unregister_sound_dsp - unregister a DSP device
  *   @unit: unit number to allocate
  *