From: Dmitry Torokhov Date: Sat, 12 Dec 2009 05:57:31 +0000 (-0800) Subject: Input: document use of input_event() function X-Git-Tag: v3.0~5016^2~97 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=df2d4637b0813e47ad12af3eacf6b5292c0fb164;p=platform%2Fkernel%2Flinux-amlogic.git Input: document use of input_event() function Acked-by: Henrique de Moraes Holschuh Signed-off-by: Dmitry Torokhov --- diff --git a/drivers/input/input.c b/drivers/input/input.c index 5c16001..ab060710 100644 --- a/drivers/input/input.c +++ b/drivers/input/input.c @@ -296,9 +296,15 @@ static void input_handle_event(struct input_dev *dev, * @value: value of the event * * This function should be used by drivers implementing various input - * devices. See also input_inject_event(). + * devices to report input events. See also input_inject_event(). + * + * NOTE: input_event() may be safely used right after input device was + * allocated with input_allocate_device(), even before it is registered + * with input_register_device(), but the event will not reach any of the + * input handlers. Such early invocation of input_event() may be used + * to 'seed' initial state of a switch or initial position of absolute + * axis, etc. */ - void input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value) {