docs: Fix bitfield handling in kernel-doc
authorDonald Hunter <donald.hunter@gmail.com>
Tue, 26 Mar 2024 17:38:25 +0000 (17:38 +0000)
committerJonathan Corbet <corbet@lwn.net>
Fri, 29 Mar 2024 14:36:27 +0000 (08:36 -0600)
commit0ec69b3bed23a4a5a88b4261afeee44ade709ed3
treeeb121bd6f18a20f26e33ccc80f22aa1b8d0beff7
parent42fb9cfd5b186fe2e615564f0a1bdd424aa1b151
docs: Fix bitfield handling in kernel-doc

kernel-doc doesn't handle bitfields that are specified with symbolic
name, e.g. u32 cs_index_mask : SPI_CS_CNT_MAX

This results in the following warnings when running `make htmldocs`:

include/linux/spi/spi.h:246: warning: Function parameter or struct member 'cs_index_mask:SPI_CS_CNT_MAX' not described in 'spi_device'
include/linux/spi/spi.h:246: warning: Excess struct member 'cs_index_mask' description in 'spi_device'

Update the regexp for bitfields to accept all word chars, not just
digits.

Signed-off-by: Donald Hunter <donald.hunter@gmail.com>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20240326173825.99190-1-donald.hunter@gmail.com
scripts/kernel-doc