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

usb: misc: iowarrior: Demote obvious misuse of kerneldoc to standard comment blocks 



No attempt has been made to document any of the demoted functions here.

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

 drivers/usb/misc/iowarrior.c:251: warning: Function parameter or member 'dev' not described in 'iowarrior_delete'
 drivers/usb/misc/iowarrior.c:279: warning: Function parameter or member 'file' not described in 'iowarrior_read'
 drivers/usb/misc/iowarrior.c:279: warning: Function parameter or member 'buffer' not described in 'iowarrior_read'
 drivers/usb/misc/iowarrior.c:279: warning: Function parameter or member 'count' not described in 'iowarrior_read'
 drivers/usb/misc/iowarrior.c:279: warning: Function parameter or member 'ppos' not described in 'iowarrior_read'
 drivers/usb/misc/iowarrior.c:483: warning: Function parameter or member 'file' not described in 'iowarrior_ioctl'
 drivers/usb/misc/iowarrior.c:483: warning: Function parameter or member 'cmd' not described in 'iowarrior_ioctl'
 drivers/usb/misc/iowarrior.c:483: warning: Function parameter or member 'arg' not described in 'iowarrior_ioctl'
 drivers/usb/misc/iowarrior.c:599: warning: Function parameter or member 'inode' not described in 'iowarrior_open'
 drivers/usb/misc/iowarrior.c:599: warning: Function parameter or member 'file' not described in 'iowarrior_open'
 drivers/usb/misc/iowarrior.c:647: warning: Function parameter or member 'inode' not described in 'iowarrior_release'
 drivers/usb/misc/iowarrior.c:647: warning: Function parameter or member 'file' not described in 'iowarrior_release'
 drivers/usb/misc/iowarrior.c:753: warning: Function parameter or member 'interface' not described in 'iowarrior_probe'
 drivers/usb/misc/iowarrior.c:753: warning: Function parameter or member 'id' not described in 'iowarrior_probe'
 drivers/usb/misc/iowarrior.c:879: warning: Function parameter or member 'interface' not described in 'iowarrior_disconnect'

Cc: Johan Hovold <johan@kernel.org>
Cc: Christian Lucht <lucht@codemercs.com>
Cc: Stephane Dalton <sdalton@videotron.ca>
Cc: Stephane Doyon <s.doyon@videotron.ca>
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20200703174148.2749969-26-lee.jones@linaro.org


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

drivers/usb/misc/iowarrior.c

+7 −7
Original line number Diff line number Diff line
@@ -244,7 +244,7 @@ static void iowarrior_write_callback(struct urb *urb) 
	wake_up_interruptible(&dev->write_wait);

}



/**

/*

 *	iowarrior_delete

 */

static inline void iowarrior_delete(struct iowarrior *dev)
@@ -271,7 +271,7 @@ static int read_index(struct iowarrior *dev) 
	return (read_idx == intr_idx ? -1 : read_idx);

}



/**

/*

 *  iowarrior_read

 */

static ssize_t iowarrior_read(struct file *file, char __user *buffer,
@@ -475,7 +475,7 @@ static ssize_t iowarrior_write(struct file *file, 
	return retval;

}



/**

/*

 *	iowarrior_ioctl

 */

static long iowarrior_ioctl(struct file *file, unsigned int cmd,
@@ -592,7 +592,7 @@ static long iowarrior_ioctl(struct file *file, unsigned int cmd, 
	return retval;

}



/**

/*

 *	iowarrior_open

 */

static int iowarrior_open(struct inode *inode, struct file *file)
@@ -640,7 +640,7 @@ static int iowarrior_open(struct inode *inode, struct file *file) 
	return retval;

}



/**

/*

 *	iowarrior_release

 */

static int iowarrior_release(struct inode *inode, struct file *file)
@@ -742,7 +742,7 @@ static struct usb_class_driver iowarrior_class = { 
/*---------------------------------*/

/*  probe and disconnect functions */

/*---------------------------------*/

/**

/*

 *	iowarrior_probe

 *

 *	Called by the usb core when a new device is connected that it thinks
@@ -870,7 +870,7 @@ static int iowarrior_probe(struct usb_interface *interface, 
	return retval;

}



/**

/*

 *	iowarrior_disconnect

 *

 *	Called by the usb core when the device is removed from the system.