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

[Randy Dunlap <rdunlap@xxxxxxxxxxxxx>]

On 7/6/24 9:14 PM, Gold Side wrote:
> From 072a5624cf67614a7f64d6ba15773f85ee5a2e1d Mon Sep 17 00:00:00 2001
> From: Steven Davis <goldside000@xxxxxxxxxxx>
> 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 <goldside000@xxxxxxxxxxx>
> ---
>  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
>   *

-- 
~Randy