lkml.org 
[lkml]   [2020]   [Jul]   [1]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH v2 06/30] misc: ibmasm: command: Demote function headers from kerneldoc
    Date
    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>
    ---
    drivers/misc/ibmasm/command.c | 6 +++---
    1 file changed, 3 insertions(+), 3 deletions(-)

    diff --git a/drivers/misc/ibmasm/command.c b/drivers/misc/ibmasm/command.c
    index 2863657fa2683..733dd30fbaccf 100644
    --- a/drivers/misc/ibmasm/command.c
    +++ b/drivers/misc/ibmasm/command.c
    @@ -94,7 +94,7 @@ static inline void do_exec_command(struct service_processor *sp)
    }
    }

    -/**
    +/*
    * exec_command
    * send a command to a service processor
    * Commands are executed sequentially. One command (sp->current_command)
    @@ -140,7 +140,7 @@ static void exec_next_command(struct service_processor *sp)
    }
    }

    -/**
    +/*
    * Sleep until a command has failed or a response has been received
    * and the command status been updated by the interrupt handler.
    * (see receive_response).
    @@ -153,7 +153,7 @@ void ibmasm_wait_for_response(struct command *cmd, int timeout)
    timeout * HZ);
    }

    -/**
    +/*
    * receive_command_response
    * called by the interrupt handler when a dot command of type command_response
    * was received.
    --
    2.25.1
    \
     
     \ /
      Last update: 2020-07-01 10:33    [W:2.907 / U:0.088 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site