[android-common:android16-6.12 0/2] htmldocs: ./include/linux/fs.h:998: warning: Excess struct member 'order' description in 'file_ra_state'

[android-common:android16-6.12 0/2] htmldocs: ./include/linux/fs.h:998: warning: Excess struct member 'order' description in 'file_ra_state'

[kernel test robot]

tree:   https://android.googlesource.com/kernel/common android16-6.12
head:   091c158be9d8e879df6ea76a6d91885c12ce322b
commit: 23aadcd1d9764a7dba1c6e3f6d63f89c2ebd435a [0/2] BACKPORT: mm/readahead: store folio order in struct file_ra_state
compiler: clang version 20.1.8 (https://github.com/llvm/llvm-project 87f0227cb60147a26a1eeb4fb06e3b505e9c7261)
docutils: docutils (Docutils 0.21.2, Python 3.13.5, on linux)
reproduce: (https://download.01.org/0day-ci/archive/20260211/202602110609.b761icz4-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/202602110609.b761icz4-lkp@intel.com/

All warnings (new ones prefixed by >>):

   ./include/linux/usb.h:1289: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(4' not described in 'usb_driver'
   ./include/linux/usb.h:1686: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(1' not described in 'urb'
   ./include/linux/usb.h:1686: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(2' not described in 'urb'
   ./include/linux/usb.h:1686: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(3' not described in 'urb'
   ./include/linux/usb.h:1686: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(4' not described in 'urb'
>> ./include/linux/fs.h:998: warning: Excess struct member 'order' description in 'file_ra_state'
   ./include/linux/fs.h:1086: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(1' not described in 'file'
   ./include/linux/fs.h:1086: warning: Function parameter or struct member 'ANDROID_KABI_RESERVE(2' not described in 'file'
   ./fs/eventpoll.c:2068: warning: Function parameter or struct member 'ep' not described in 'ep_get_upwards_depth_proc'
   ./fs/eventpoll.c:2068: warning: Function parameter or struct member 'depth' not described in 'ep_get_upwards_depth_proc'
   ./include/drm/drm_drv.h:372: warning: Incorrect use of kernel-doc format:          * @fbdev_probe


vim +998 ./include/linux/fs.h

^1da177e4c3f41 Linus Torvalds          2005-04-16  975  
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  976) /**
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  977)  * struct file_ra_state - Track a file's readahead state.
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  978)  * @start: Where the most recent readahead started.
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  979)  * @size: Number of pages read in the most recent readahead.
84dacdbd5352bf NeilBrown               2022-03-22  980   * @async_size: Numer of pages that were/are not needed immediately
84dacdbd5352bf NeilBrown               2022-03-22  981   *      and so were/are genuinely "ahead".  Start next readahead when
84dacdbd5352bf NeilBrown               2022-03-22  982   *      the first of these pages is accessed.
84dacdbd5352bf NeilBrown               2022-03-22  983   * @ra_pages: Maximum size of a readahead request, copied from the bdi.
23aadcd1d9764a Ryan Roberts            2025-06-09  984   * @order: Preferred folio order used for most recent readahead.
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  985)  * @mmap_miss: How many mmap accesses missed in the page cache.
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  986)  * @prev_pos: The last byte in the most recent read request.
84dacdbd5352bf NeilBrown               2022-03-22  987   *
84dacdbd5352bf NeilBrown               2022-03-22  988   * When this structure is passed to ->readahead(), the "most recent"
84dacdbd5352bf NeilBrown               2022-03-22  989   * readahead means the current readahead.
^1da177e4c3f41 Linus Torvalds          2005-04-16  990   */
^1da177e4c3f41 Linus Torvalds          2005-04-16  991  struct file_ra_state {
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  992) 	pgoff_t start;
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  993) 	unsigned int size;
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  994) 	unsigned int async_size;
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  995) 	unsigned int ra_pages;
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  996) 	unsigned int mmap_miss;
c790fbf20a53e8 Matthew Wilcox (Oracle  2021-04-07  997) 	loff_t prev_pos;
^1da177e4c3f41 Linus Torvalds          2005-04-16 @998  };
^1da177e4c3f41 Linus Torvalds          2005-04-16  999  

:::::: The code at line 998 was first introduced by commit
:::::: 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 Linux-2.6.12-rc2

:::::: TO: Linus Torvalds <torvalds@ppc970.osdl.org>
:::::: CC: Linus Torvalds <torvalds@ppc970.osdl.org>

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