drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'slave' not described in 'axxia_i2c_dev'

drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'slave' not described in 'axxia_i2c_dev'

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   06dc10eae55b5ceabfef287a7e5f16ceea204aa0
commit: e49560f02716839a74a7907200a589c1f990261b i2c: axxia: use 'struct' for kernel-doc notation
date:   9 months ago
config: x86_64-buildonly-randconfig-006-20230906 (https://download.01.org/0day-ci/archive/20231018/202310181049.Vo62moV1-lkp@intel.com/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/20231018/202310181049.Vo62moV1-lkp@intel.com/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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202310181049.Vo62moV1-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'slave' not described in 'axxia_i2c_dev'
>> drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'irq' not described in 'axxia_i2c_dev'
   drivers/i2c/busses/i2c-axxia.c:172: warning: Function parameter or member 'ns' not described in 'ns_to_clk'
   drivers/i2c/busses/i2c-axxia.c:172: warning: Function parameter or member 'clk_mhz' not described in 'ns_to_clk'
   drivers/i2c/busses/i2c-axxia.c:271: warning: Function parameter or member 'idev' not described in 'axxia_i2c_empty_rx_fifo'
   drivers/i2c/busses/i2c-axxia.c:303: warning: Function parameter or member 'idev' not described in 'axxia_i2c_fill_tx_fifo'


vim +150 drivers/i2c/busses/i2c-axxia.c

08678b850cd0c4 Anders Berg                             2014-10-03  119  
08678b850cd0c4 Anders Berg                             2014-10-03  120  /**
e49560f0271683 Randy Dunlap                            2023-01-12  121   * struct axxia_i2c_dev - I2C device context
08678b850cd0c4 Anders Berg                             2014-10-03  122   * @base: pointer to register struct
08678b850cd0c4 Anders Berg                             2014-10-03  123   * @msg: pointer to current message
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw  2018-12-13  124)  * @msg_r: pointer to current read message (sequence transfer)
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw  2018-12-13  125)  * @msg_xfrd: number of bytes transferred in tx_fifo
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw  2018-12-13  126)  * @msg_xfrd_r: number of bytes transferred in rx_fifo
08678b850cd0c4 Anders Berg                             2014-10-03  127   * @msg_err: error code for completed message
08678b850cd0c4 Anders Berg                             2014-10-03  128   * @msg_complete: xfer completion object
08678b850cd0c4 Anders Berg                             2014-10-03  129   * @dev: device reference
08678b850cd0c4 Anders Berg                             2014-10-03  130   * @adapter: core i2c abstraction
08678b850cd0c4 Anders Berg                             2014-10-03  131   * @i2c_clk: clock reference for i2c input clock
08678b850cd0c4 Anders Berg                             2014-10-03  132   * @bus_clk_rate: current i2c bus clock rate
530edb501ce476 Adamski, Krzysztof (Nokia - PL/Wroclaw  2019-03-28  133)  * @last: a flag indicating is this is last message in transfer
08678b850cd0c4 Anders Berg                             2014-10-03  134   */
08678b850cd0c4 Anders Berg                             2014-10-03  135  struct axxia_i2c_dev {
08678b850cd0c4 Anders Berg                             2014-10-03  136  	void __iomem *base;
08678b850cd0c4 Anders Berg                             2014-10-03  137  	struct i2c_msg *msg;
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw  2018-12-13  138) 	struct i2c_msg *msg_r;
08678b850cd0c4 Anders Berg                             2014-10-03  139  	size_t msg_xfrd;
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw  2018-12-13  140) 	size_t msg_xfrd_r;
08678b850cd0c4 Anders Berg                             2014-10-03  141  	int msg_err;
08678b850cd0c4 Anders Berg                             2014-10-03  142  	struct completion msg_complete;
08678b850cd0c4 Anders Berg                             2014-10-03  143  	struct device *dev;
08678b850cd0c4 Anders Berg                             2014-10-03  144  	struct i2c_adapter adapter;
08678b850cd0c4 Anders Berg                             2014-10-03  145  	struct clk *i2c_clk;
08678b850cd0c4 Anders Berg                             2014-10-03  146  	u32 bus_clk_rate;
530edb501ce476 Adamski, Krzysztof (Nokia - PL/Wroclaw  2019-03-28  147) 	bool last;
f0b576801d83ce Adamski, Krzysztof (Nokia - PL/Wroclaw  2019-08-19  148) 	struct i2c_client *slave;
f0b576801d83ce Adamski, Krzysztof (Nokia - PL/Wroclaw  2019-08-19  149) 	int irq;
08678b850cd0c4 Anders Berg                             2014-10-03 @150  };
08678b850cd0c4 Anders Berg                             2014-10-03  151  

:::::: The code at line 150 was first introduced by commit
:::::: 08678b850cd0c49cc49c7fed0c93f720f85368e8 i2c: axxia: Add I2C driver for AXM55xx

:::::: TO: Anders Berg <anders.berg@avagotech.com>
:::::: CC: Wolfram Sang <wsa@the-dreams.de>

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