iv/linux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

rsi: fix comment syntax in file headers

Browse Source 
The opening comment mark '/**' is used for highlighting the beginning of
kernel-doc comments.
There are some files in drivers/net/wireless/rsi which follow this syntax
in their file headers, i.e. start with '/**' like comments, which causes
unexpected warnings from kernel-doc.

E.g., running scripts/kernel-doc -none on drivers/net/wireless/rsi/rsi_coex.h
causes this warning:
"warning: wrong kernel-doc identifier on line:
 * Copyright (c) 2018 Redpine Signals Inc."

Similarly for other files too.

Provide a simple fix by replacing such occurrences with general comment
format, i.e., "/*", to prevent kernel-doc from parsing it.

Signed-off-by: Aditya Srivastava <yashsri421@gmail.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Kalle Valo <kvalo@codeaurora.org>
Link: https://lore.kernel.org/r/20210315173259.8757-1-yashsri421@gmail.com
This commit is contained in:
Aditya Srivastava 2021-03-15 23:02:59 +05:30 committed by Kalle Valo
parent 7909a590eb
commit 3051946056
10 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
drivers/net/wireless/rsi/rsi_boot_params.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2014 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_coex.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2018 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_common.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2014 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_debugfs.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2014 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_hal.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2017 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_main.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2014 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_mgmt.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2014 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_ps.h
View File

@ -1,4 +1,4 @@
/**
/*
* Copyright (c) 2017 Redpine Signals Inc.
*
* Permission to use, copy, modify, and/or distribute this software for any

2
drivers/net/wireless/rsi/rsi_sdio.h
View File

@ -1,4 +1,4 @@
/**
/*
* @section LICENSE
* Copyright (c) 2014 Redpine Signals Inc.
*

2
drivers/net/wireless/rsi/rsi_usb.h
View File

@ -1,4 +1,4 @@
/**
/*
* @section LICENSE
* Copyright (c) 2014 Redpine Signals Inc.
*