Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 7dc87919 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

[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: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 276ce3a8

include/media/v4l2-ctrls.h

+8 −1
Original line number Diff line number Diff line
@@ -159,12 +159,17 @@ typedef void (*v4l2_ctrl_notify_fnc)(struct v4l2_ctrl *ctrl, void *priv); 
 * @flags:	The control's flags.

 * @cur:	The control's current value.

 * @val:	The control's new s32 value.

 * @val64:	The control's new s64 value.

 * @priv:	The control's private pointer. For use by the driver. It is

 *		untouched by the control framework. Note that this pointer is

 *		not freed when the control is deleted. Should this be needed

 *		then a new internal bitfield can be added to tell the framework

 *		to free this pointer.

 * @p_cur:	The control's current value represented via an union with

 *		provides a standard way of accessing control types

 *		through a pointer.

 * @p_new:	The control's new value represented via an union with provides

 *		a standard way of accessing control types

 *		through a pointer.

 */

struct v4l2_ctrl {

	/* Administrative fields */
@@ -291,6 +296,8 @@ struct v4l2_ctrl_handler { 
 *		empty strings ("") correspond to non-existing menu items (this

 *		is in addition to the menu_skip_mask above). The last entry

 *		must be NULL.

 * @qmenu_int:	A const s64 integer array for all menu items of the type

 * 		V4L2_CTRL_TYPE_INTEGER_MENU.

 * @is_private: If set, then this control is private to its handler and it

 *		will not be added to any other handlers.

 */