linux/tools/lib/python/kdoc
Randy Dunlap 713e899a68 docs: xforms_lists: allow __maybe_unused in func parameters
Bart has a patch (not yet merged) that causes kernel-doc warnings:

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

Handle this by adding "__maybe_unused" to the list of known function
parameter modifiers.

Reported-by: kernel test robot <lkp@intel.com>
Closes: https://lore.kernel.org/oe-kbuild-all/202604120025.jtlnpWff-lkp@intel.com/
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Bart Van Assche <bvanassche@acm.org>
Reviewed-by: Bart Van Assche <bvanassche@acm.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20260411233526.3909303-1-rdunlap@infradead.org>
2026-04-27 04:07:06 -06:00
..
__init__.py docs: bring some order to our Python module hierarchy 2025-11-18 09:22:40 -07:00
c_lex.py docs: c_lex.py: store logger on its data 2026-03-25 13:36:46 -06:00
enrich_formatter.py docs: kdoc: enrich_formatter: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
kdoc_files.py doc tools: better handle KBUILD_VERBOSE 2026-03-30 10:03:40 -06:00
kdoc_item.py docs: kdoc: better handle source when producing YAML output 2026-03-25 13:36:46 -06:00
kdoc_output.py docs: kdoc_output: raise an error if full_proto not available for var 2026-03-25 13:36:46 -06:00
kdoc_parser.py Crypto library fix and documentation update for 7.1 2026-04-21 11:46:22 -07:00
kdoc_re.py docs: kdoc_re: better represent long regular expressions 2026-03-22 15:10:40 -06:00
kdoc_yaml_file.py docs: kdoc_yaml_file: use a better name for the tests 2026-03-25 13:36:46 -06:00
latex_fonts.py docs: kdoc: latex_fonts: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
parse_data_structs.py docs: kdoc: parse_data_structs: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
python_version.py docs: kdoc: python_version: Improve docstrings and comments 2026-01-23 11:37:38 -07:00
xforms_lists.py docs: xforms_lists: allow __maybe_unused in func parameters 2026-04-27 04:07:06 -06:00