diff mbox series

[v2] ipw2x00: Minor documentation update

Message ID 1619348088-6887-1-git-send-email-jrdr.linux@gmail.com
State Superseded
Headers show
Series [v2] ipw2x00: Minor documentation update | expand

Commit Message

Souptick Joarder April 25, 2021, 10:54 a.m. UTC
Kernel test robot throws below warning ->

drivers/net/wireless/intel/ipw2x00/ipw2100.c:5359: warning: This comment
starts with '/**', but isn't a kernel-doc comment. Refer
Documentation/doc-guide/kernel-doc.rst

Minor update in documentation.

Reported-by: kernel test robot <lkp@intel.com>
Signed-off-by: Souptick Joarder <jrdr.linux@gmail.com>
Cc: Randy Dunlap <rdunlap@infradead.org>
---
v2:
	Updated docs.

 drivers/net/wireless/intel/ipw2x00/ipw2100.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Comments

Randy Dunlap April 25, 2021, 4:10 p.m. UTC | #1
On 4/25/21 3:54 AM, Souptick Joarder wrote:
> Kernel test robot throws below warning ->
> 
> drivers/net/wireless/intel/ipw2x00/ipw2100.c:5359: warning: This comment
> starts with '/**', but isn't a kernel-doc comment. Refer
> Documentation/doc-guide/kernel-doc.rst
> 
> Minor update in documentation.
> 
> Reported-by: kernel test robot <lkp@intel.com>
> Signed-off-by: Souptick Joarder <jrdr.linux@gmail.com>
> Cc: Randy Dunlap <rdunlap@infradead.org>

Acked-by: Randy Dunlap <rdunlap@infradead.org>

Thanks.

> ---
> v2:
> 	Updated docs.
> 
>  drivers/net/wireless/intel/ipw2x00/ipw2100.c | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/drivers/net/wireless/intel/ipw2x00/ipw2100.c b/drivers/net/wireless/intel/ipw2x00/ipw2100.c
> index 23fbddd..eeac9e3 100644
> --- a/drivers/net/wireless/intel/ipw2x00/ipw2100.c
> +++ b/drivers/net/wireless/intel/ipw2x00/ipw2100.c
> @@ -5356,7 +5356,7 @@ struct ipw2100_wep_key {
>  #define WEP_STR_128(x) x[0],x[1],x[2],x[3],x[4],x[5],x[6],x[7],x[8],x[9],x[10]
>  
>  /**
> - * Set a the wep key
> + * ipw2100_set_key() - Set the wep key
>   *
>   * @priv: struct to work on
>   * @idx: index of the key we want to set
>
Souptick Joarder June 23, 2021, 7:18 p.m. UTC | #2
On Tue, Jun 15, 2021 at 7:05 PM Kalle Valo <kvalo@codeaurora.org> wrote:
>

> Souptick Joarder <jrdr.linux@gmail.com> wrote:

>

> > Kernel test robot throws below warning ->

> >

> > drivers/net/wireless/intel/ipw2x00/ipw2100.c:5359: warning: This comment

> > starts with '/**', but isn't a kernel-doc comment. Refer

> > Documentation/doc-guide/kernel-doc.rst

> >

> > Minor update in documentation.

> >

> > Reported-by: kernel test robot <lkp@intel.com>

> > Signed-off-by: Souptick Joarder <jrdr.linux@gmail.com>

> > Cc: Randy Dunlap <rdunlap@infradead.org>

> > Acked-by: Randy Dunlap <rdunlap@infradead.org>

>

> Fails to apply, please rebase.


Sure.
>

> Recorded preimage for 'drivers/net/wireless/intel/ipw2x00/ipw2100.c'

> error: Failed to merge in the changes.

> hint: Use 'git am --show-current-patch' to see the failed patch

> Applying: ipw2x00: Minor documentation update

> Using index info to reconstruct a base tree...

> M       drivers/net/wireless/intel/ipw2x00/ipw2100.c

> Falling back to patching base and 3-way merge...

> Auto-merging drivers/net/wireless/intel/ipw2x00/ipw2100.c

> CONFLICT (content): Merge conflict in drivers/net/wireless/intel/ipw2x00/ipw2100.c

> Patch failed at 0001 ipw2x00: Minor documentation update

>

> Patch set to Changes Requested.

>

> --

> https://patchwork.kernel.org/project/linux-wireless/patch/1619348088-6887-1-git-send-email-jrdr.linux@gmail.com/

>

> https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches

>
diff mbox series

Patch

diff --git a/drivers/net/wireless/intel/ipw2x00/ipw2100.c b/drivers/net/wireless/intel/ipw2x00/ipw2100.c
index 23fbddd..eeac9e3 100644
--- a/drivers/net/wireless/intel/ipw2x00/ipw2100.c
+++ b/drivers/net/wireless/intel/ipw2x00/ipw2100.c
@@ -5356,7 +5356,7 @@  struct ipw2100_wep_key {
 #define WEP_STR_128(x) x[0],x[1],x[2],x[3],x[4],x[5],x[6],x[7],x[8],x[9],x[10]
 
 /**
- * Set a the wep key
+ * ipw2100_set_key() - Set the wep key
  *
  * @priv: struct to work on
  * @idx: index of the key we want to set