Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

misc: mic: host: mic_debugfs: Demote function headers from kerneldoc

The correct format is not used and no attempt has been made
to document the function arguments. Makes sense to just demote
the headers back down to simple comments.

Fixes the following W=1 warnings:

drivers/misc/mic/host/mic_debugfs.c:108: warning: Function parameter or member 'mdev' not described in 'mic_create_debug_dir'
drivers/misc/mic/host/mic_debugfs.c:131: warning: Function parameter or member 'mdev' not described in 'mic_delete_debug_dir'

Cc: Sudeep Dutt <sudeep.dutt@intel.com>
Cc: Ashutosh Dixit <ashutosh.dixit@intel.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20200701083118.45744-15-lee.jones@linaro.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Lee Jones and committed by
Greg Kroah-Hartman
438ad368 49f093f4

+4 -4
+4 -4
drivers/misc/mic/host/mic_debugfs.c
··· 101 101 102 102 DEFINE_SHOW_ATTRIBUTE(mic_msi_irq_info); 103 103 104 - /** 104 + /* 105 105 * mic_create_debug_dir - Initialize MIC debugfs entries. 106 106 */ 107 107 void mic_create_debug_dir(struct mic_device *mdev) ··· 124 124 &mic_msi_irq_info_fops); 125 125 } 126 126 127 - /** 127 + /* 128 128 * mic_delete_debug_dir - Uninitialize MIC debugfs entries. 129 129 */ 130 130 void mic_delete_debug_dir(struct mic_device *mdev) ··· 132 132 debugfs_remove_recursive(mdev->dbg_dir); 133 133 } 134 134 135 - /** 135 + /* 136 136 * mic_init_debugfs - Initialize global debugfs entry. 137 137 */ 138 138 void __init mic_init_debugfs(void) ··· 140 140 mic_dbg = debugfs_create_dir(KBUILD_MODNAME, NULL); 141 141 } 142 142 143 - /** 143 + /* 144 144 * mic_exit_debugfs - Uninitialize global debugfs entry 145 145 */ 146 146 void mic_exit_debugfs(void)