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

[media] v4l2-ctrls.h: Document a few missing arguments

Warning(.//include/media/v4l2-ctrls.h:217): No description found for parameter 'p_new'
Warning(.//include/media/v4l2-ctrls.h:217): No description found for parameter 'p_cur'
Warning(.//include/media/v4l2-ctrls.h:217): Excess struct/union/enum/typedef member 'val64' description in 'v4l2_ctrl'
Warning(.//include/media/v4l2-ctrls.h:314): No description found for parameter 'qmenu_int'

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Acked-by: Jonathan Corbet <corbet@lwn.net>

+8 -1
+8 -1
include/media/v4l2-ctrls.h
··· 159 159 * @flags: The control's flags. 160 160 * @cur: The control's current value. 161 161 * @val: The control's new s32 value. 162 - * @val64: The control's new s64 value. 163 162 * @priv: The control's private pointer. For use by the driver. It is 164 163 * untouched by the control framework. Note that this pointer is 165 164 * not freed when the control is deleted. Should this be needed 166 165 * then a new internal bitfield can be added to tell the framework 167 166 * to free this pointer. 167 + * @p_cur: The control's current value represented via an union with 168 + * provides a standard way of accessing control types 169 + * through a pointer. 170 + * @p_new: The control's new value represented via an union with provides 171 + * a standard way of accessing control types 172 + * through a pointer. 168 173 */ 169 174 struct v4l2_ctrl { 170 175 /* Administrative fields */ ··· 296 291 * empty strings ("") correspond to non-existing menu items (this 297 292 * is in addition to the menu_skip_mask above). The last entry 298 293 * must be NULL. 294 + * @qmenu_int: A const s64 integer array for all menu items of the type 295 + * V4L2_CTRL_TYPE_INTEGER_MENU. 299 296 * @is_private: If set, then this control is private to its handler and it 300 297 * will not be added to any other handlers. 301 298 */