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

misc: ibmasm: command: 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 header back down to a simple comment.

Fixes the following W=1 warnings:

drivers/misc/ibmasm/command.c:106: warning: Function parameter or member 'sp' not described in 'ibmasm_exec_command'
drivers/misc/ibmasm/command.c:106: warning: Function parameter or member 'cmd' not described in 'ibmasm_exec_command'
drivers/misc/ibmasm/command.c:149: warning: Function parameter or member 'cmd' not described in 'ibmasm_wait_for_response'
drivers/misc/ibmasm/command.c:149: warning: Function parameter or member 'timeout' not described in 'ibmasm_wait_for_response'
drivers/misc/ibmasm/command.c:162: warning: Function parameter or member 'sp' not described in 'ibmasm_receive_command_response'
drivers/misc/ibmasm/command.c:162: warning: Function parameter or member 'response' not described in 'ibmasm_receive_command_response'
drivers/misc/ibmasm/command.c:162: warning: Function parameter or member 'size' not described in 'ibmasm_receive_command_response'

Cc: "Max Asböck" <amax@us.ibm.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20200701083118.45744-7-lee.jones@linaro.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Lee Jones and committed by
Greg Kroah-Hartman
b7df87cf 63969cf2

+3 -3
+3 -3
drivers/misc/ibmasm/command.c
··· 94 94 } 95 95 } 96 96 97 - /** 97 + /* 98 98 * exec_command 99 99 * send a command to a service processor 100 100 * Commands are executed sequentially. One command (sp->current_command) ··· 140 140 } 141 141 } 142 142 143 - /** 143 + /* 144 144 * Sleep until a command has failed or a response has been received 145 145 * and the command status been updated by the interrupt handler. 146 146 * (see receive_response). ··· 153 153 timeout * HZ); 154 154 } 155 155 156 - /** 156 + /* 157 157 * receive_command_response 158 158 * called by the interrupt handler when a dot command of type command_response 159 159 * was received.