[linux-next:master 2098/2998] htmldocs: ./include/net/page_pool/types.h:73: warning: Function parameter or member 'STRUCT_GROUP(' not described in 'page_pool_params'

[kernel test robot <lkp@intel.com>]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master
head:   8c9660f6515396aba78d1168d2e17951d653ebf2
commit: 5027ec19f1049a07df5b0a37b1f462514cf2724b [2098/2998] net: page_pool: split the page_pool_params into fast and slow
reproduce: (https://download.01.org/0day-ci/archive/20231125/202311250015.4rqAghbA-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/202311250015.4rqAghbA-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> ./include/net/page_pool/types.h:73: warning: Function parameter or member 'STRUCT_GROUP(' not described in 'page_pool_params'

vim +73 ./include/net/page_pool/types.h

a9ca9f9ceff382b Yunsheng Lin   2023-08-04  43  
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  44  /**
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  45   * struct page_pool_params - page pool parameters
09d96ee5674a0ea Yunsheng Lin   2023-10-20  46   * @flags:	PP_FLAG_DMA_MAP, PP_FLAG_DMA_SYNC_DEV
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  47   * @order:	2^order pages on allocation
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  48   * @pool_size:	size of the ptr_ring
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  49   * @nid:	NUMA node id to allocate from pages from
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  50   * @dev:	device, for DMA pre-mapping purposes
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  51   * @napi:	NAPI which is the sole consumer of pages, otherwise NULL
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  52   * @dma_dir:	DMA mapping direction
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  53   * @max_len:	max DMA sync memory size for PP_FLAG_DMA_SYNC_DEV
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  54   * @offset:	DMA sync address offset for PP_FLAG_DMA_SYNC_DEV
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  55   */
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  56  struct page_pool_params {
5027ec19f1049a0 Jakub Kicinski 2023-11-20  57  	struct_group_tagged(page_pool_params_fast, fast,
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  58  		unsigned int	flags;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  59  		unsigned int	order;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  60  		unsigned int	pool_size;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  61  		int		nid;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  62  		struct device	*dev;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  63  		struct napi_struct *napi;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  64  		enum dma_data_direction dma_dir;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  65  		unsigned int	max_len;
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  66  		unsigned int	offset;
5027ec19f1049a0 Jakub Kicinski 2023-11-20  67  	);
5027ec19f1049a0 Jakub Kicinski 2023-11-20  68  	struct_group_tagged(page_pool_params_slow, slow,
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  69  /* private: used by test code only */
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  70  		void (*init_callback)(struct page *page, void *arg);
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  71  		void *init_arg;
5027ec19f1049a0 Jakub Kicinski 2023-11-20  72  	);
a9ca9f9ceff382b Yunsheng Lin   2023-08-04 @73  };
a9ca9f9ceff382b Yunsheng Lin   2023-08-04  74  

:::::: The code at line 73 was first introduced by commit
:::::: a9ca9f9ceff382b58b488248f0c0da9e157f5d06 page_pool: split types and declarations from page_pool.h

:::::: TO: Yunsheng Lin <linyunsheng@huawei.com>
:::::: CC: Jakub Kicinski <kuba@kernel.org>

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