mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-15 06:55:13 +08:00
3051946056
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
49 lines
1.4 KiB
C
49 lines
1.4 KiB
C
/*
|
|
* Copyright (c) 2014 Redpine Signals Inc.
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#ifndef __RSI_DEBUGFS_H__
|
|
#define __RSI_DEBUGFS_H__
|
|
|
|
#include "rsi_main.h"
|
|
#include <linux/debugfs.h>
|
|
|
|
#ifndef CONFIG_RSI_DEBUGFS
|
|
static inline int rsi_init_dbgfs(struct rsi_hw *adapter)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void rsi_remove_dbgfs(struct rsi_hw *adapter)
|
|
{
|
|
return;
|
|
}
|
|
#else
|
|
struct rsi_dbg_files {
|
|
const char *name;
|
|
umode_t perms;
|
|
const struct file_operations fops;
|
|
};
|
|
|
|
struct rsi_debugfs {
|
|
struct dentry *subdir;
|
|
struct rsi_dbg_ops *dfs_get_ops;
|
|
struct dentry *rsi_files[MAX_DEBUGFS_ENTRIES];
|
|
};
|
|
int rsi_init_dbgfs(struct rsi_hw *adapter);
|
|
void rsi_remove_dbgfs(struct rsi_hw *adapter);
|
|
#endif
|
|
#endif
|