tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

usb: typec: Document priority and mode_selection fields in struct typec_altmode

The fields 'priority' and 'mode_selection' in struct typec_altmode are
missing from the kernel-doc comment, which results in warnings when
building the documentation with 'make htmldocs'.

WARNING: ./include/linux/usb/typec_altmode.h:44 struct member 'priority' not described in 'typec_altmode'
WARNING: ./include/linux/usb/typec_altmode.h:44 struct member 'mode_selection' not described in 'typec_altmode'

Document both fields to keep the kernel-doc comment aligned with the
structure definition.

Signed-off-by: Aldo Conte <aldocontelk@gmail.com>
Reviewed-by: Heikki Krogerus <heikki.krogerus@linux.intel.com>
Link: https://patch.msgid.link/20260311163320.61534-1-aldocontelk@gmail.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Aldo Conte and committed by
Greg Kroah-Hartman f8a5f693 351eb144

+3
+3
include/linux/usb/typec_altmode.h
··· 26 26 * @mode: Index of the Mode 27 27 * @vdo: VDO returned by Discover Modes USB PD command 28 28 * @active: Tells has the mode been entered or not 29 + * @priority: Priority used by the automatic alternate mode selection process 30 + * @mode_selection: Whether entry to this alternate mode is managed by the 31 + * automatic alternate mode selection process or by the specific driver 29 32 * @desc: Optional human readable description of the mode 30 33 * @ops: Operations vector from the driver 31 34 * @cable_ops: Cable operations vector from the driver.