Commit 33c6527a authored by Lee Jones's avatar Lee Jones Committed by Greg Kroah-Hartman
Browse files

bus: fsl-mc: mc-sys: Supply missing function names in kernel-doc headers 



Fixes the following W=1 kernel build warning(s):

 drivers/bus/fsl-mc/mc-sys.c:20: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 drivers/bus/fsl-mc/mc-sys.c:151: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 drivers/bus/fsl-mc/mc-sys.c:197: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 drivers/bus/fsl-mc/mc-sys.c:237: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Cc: Stuart Yoder <stuyoder@gmail.com>
Reviewed-by: default avatarLaurentiu Tudor <laurentiu.tudor@nxp.com>
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20210617110500.15907-2-lee.jones@linaro.org


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 337c7563

drivers/bus/fsl-mc/mc-sys.c

+10 −9
Original line number Diff line number Diff line
@@ -16,7 +16,7 @@ 


#include "fsl-mc-private.h"



/**

/*

 * Timeout in milliseconds to wait for the completion of an MC command

 */

#define MC_CMD_COMPLETION_TIMEOUT_MS	500
@@ -148,9 +148,10 @@ static inline enum mc_cmd_status mc_read_response(struct fsl_mc_command __iomem 
}



/**

 * Waits for the completion of an MC command doing preemptible polling.

 * uslepp_range() is called between polling iterations.

 *

 * mc_polling_wait_preemptible() - Waits for the completion of an MC

 *                                 command doing preemptible polling.

 *                                 uslepp_range() is called between

 *                                 polling iterations.

 * @mc_io: MC I/O object to be used

 * @cmd: command buffer to receive MC response

 * @mc_status: MC command completion status
@@ -194,9 +195,9 @@ static int mc_polling_wait_preemptible(struct fsl_mc_io *mc_io, 
}



/**

 * Waits for the completion of an MC command doing atomic polling.

 * udelay() is called between polling iterations.

 *

 * mc_polling_wait_atomic() - Waits for the completion of an MC command

 *                            doing atomic polling. udelay() is called

 *                            between polling iterations.

 * @mc_io: MC I/O object to be used

 * @cmd: command buffer to receive MC response

 * @mc_status: MC command completion status
@@ -234,8 +235,8 @@ static int mc_polling_wait_atomic(struct fsl_mc_io *mc_io, 
}



/**

 * Sends a command to the MC device using the given MC I/O object

 *

 * mc_send_command() - Sends a command to the MC device using the given

 *                     MC I/O object

 * @mc_io: MC I/O object to be used

 * @cmd: command to be sent

 *