drivers/hid/intel-ish-hid/ishtp/bus.c:853: warning: Function parameter or member 'dev' not described in 'ishtp_wait_resume'

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   77fa2fbe87fc605c4bfa87dff87be9bfded0e9a3
commit: e48bf29cf9d6d60d810e2af71e54b71a324094e0 HID: intel-ish-hid: use async resume function
date:   2 years, 4 months ago
config: x86_64-randconfig-004-20230909 (https://download.01.org/0day-ci/archive/20231106/202311060843.dXENYlGc-lkp@xxxxxxxxx/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231106/202311060843.dXENYlGc-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202311060843.dXENYlGc-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/hid/intel-ish-hid/ishtp/bus.c:853: warning: Function parameter or member 'dev' not described in 'ishtp_wait_resume'


vim +853 drivers/hid/intel-ish-hid/ishtp/bus.c

   844	
   845	/**
   846	 * ishtp_wait_resume() - Wait for IPC resume
   847	 *
   848	 * Wait for IPC resume
   849	 *
   850	 * Return: resume complete or not
   851	 */
   852	bool ishtp_wait_resume(struct ishtp_device *dev)
 > 853	{
   854		/* 50ms to get resume response */
   855		#define WAIT_FOR_RESUME_ACK_MS		50
   856	
   857		/* Waiting to get resume response */
   858		if (dev->resume_flag)
   859			wait_event_interruptible_timeout(dev->resume_wait,
   860							 !dev->resume_flag,
   861							 msecs_to_jiffies(WAIT_FOR_RESUME_ACK_MS));
   862	
   863		return (!dev->resume_flag);
   864	}
   865	EXPORT_SYMBOL_GPL(ishtp_wait_resume);
   866	

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki