[bvanassche:thread-safety 95/95] htmldocs: Documentation/mm/highmem:211: ./include/linux/highmem.h:222: WARNING: Error in declarator or parameters

[bvanassche:thread-safety 95/95] htmldocs: Documentation/mm/highmem:211: ./include/linux/highmem.h:222: WARNING: Error in declarator or parameters

[kernel test robot]

tree:   https://github.com/bvanassche/linux thread-safety
head:   834588da5a3bc2696586cdc98024dcebec97aeed
commit: 834588da5a3bc2696586cdc98024dcebec97aeed [95/95] treewide: Build fixes
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/20260412/202604120025.jtlnpWff-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/202604120025.jtlnpWff-lkp@intel.com/

All warnings (new ones prefixed by >>):

   Runtime Survivability
   ===================== [docutils]
   WARNING: ./include/linux/highmem.h:235 function parameter '__maybe_unused' not described in 'clear_user_pages'
   WARNING: ./include/linux/highmem.h:235 function parameter '__maybe_unused' not described in 'clear_user_pages'
>> Documentation/mm/highmem:211: ./include/linux/highmem.h:222: WARNING: Error in declarator or parameters
   Invalid C declaration: Expecting "," or ")" in parameters, got "_". [error at 55]
   void clear_user_pages (void *addr, unsigned long vaddr __maybe_unused, struct page *page, unsigned int npages)
   -------------------------------------------------------^
   Documentation/mm/memfd_preservation:7: ./mm/memfd_luo.c:13: ERROR: Unexpected section title.

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

Re: [bvanassche:thread-safety 95/95] htmldocs: Documentation/mm/highmem:211: ./include/linux/highmem.h:222: WARNING: Error in declarator or parameters

[Randy Dunlap]

On 4/11/26 3:24 PM, kernel test robot wrote:
> tree:   https://github.com/bvanassche/linux thread-safety
> head:   834588da5a3bc2696586cdc98024dcebec97aeed
> commit: 834588da5a3bc2696586cdc98024dcebec97aeed [95/95] treewide: Build fixes
> 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/20260412/202604120025.jtlnpWff-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/202604120025.jtlnpWff-lkp@intel.com/
> 
> All warnings (new ones prefixed by >>):
> 
>    Runtime Survivability
>    ===================== [docutils]
>    WARNING: ./include/linux/highmem.h:235 function parameter '__maybe_unused' not described in 'clear_user_pages'
>    WARNING: ./include/linux/highmem.h:235 function parameter '__maybe_unused' not described in 'clear_user_pages'
>>> Documentation/mm/highmem:211: ./include/linux/highmem.h:222: WARNING: Error in declarator or parameters
>    Invalid C declaration: Expecting "," or ")" in parameters, got "_". [error at 55]
>    void clear_user_pages (void *addr, unsigned long vaddr __maybe_unused, struct page *page, unsigned int npages)
>    -------------------------------------------------------^
>    Documentation/mm/memfd_preservation:7: ./mm/memfd_luo.c:13: ERROR: Unexpected section title.
> 

Patch for allowing __maybe_unused is here:
https://lore.kernel.org/linux-doc/20260411233526.3909303-1-rdunlap@infradead.org/T/#u

-- 
~Randy