From 8963f96d52ccf88587f74f50968e4fa23216a908 Mon Sep 17 00:00:00 2001
From: Dmitry Torokhov <dtor@insightbb.com>
Date: Thu, 2 Nov 2006 23:26:55 -0500
Subject: [PATCH] --- yaml --- r: 39663 b: refs/heads/master c:
 1447190e39847cc2cc8a826e7061989c83ff4362 h: refs/heads/master i:   39661:
 616071a0994519a4acb2ca58b7c982055799fb96   39659:
 58dea5b8c4680d5341a49647d12d7868f3c7e0f2   39655:
 cd9e8d712ee789828660319d8c8272f53b69cafd   39647:
 0850d3d6c0b1ebd506512abebed6bcbe0cbbb48b v: v3

---
 [refs]                      |  2 +-
 trunk/drivers/input/input.c | 25 ++++++++++++++++++++++++-
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/[refs] b/[refs]
index 7b9a5ffed5d7..927339b2c47f 100644
--- a/[refs]
+++ b/[refs]
@@ -1,2 +1,2 @@
 ---
-refs/heads/master: b435fdcda126db42343b8055d04a0a27c229717b
+refs/heads/master: 1447190e39847cc2cc8a826e7061989c83ff4362
diff --git a/trunk/drivers/input/input.c b/trunk/drivers/input/input.c
index 1c8c8a5bc4a9..7cf2b4f603a3 100644
--- a/trunk/drivers/input/input.c
+++ b/trunk/drivers/input/input.c
@@ -37,7 +37,7 @@ static struct input_handler *input_table[8];
 
 /**
  * input_event() - report new input event
- * @handle: device that generated the event
+ * @dev: device that generated the event
  * @type: type of the event
  * @code: event code
  * @value: value of the event
@@ -900,6 +900,15 @@ struct class input_class = {
 };
 EXPORT_SYMBOL_GPL(input_class);
 
+/**
+ * input_allocate_device - allocate memory for new input device
+ *
+ * Returns prepared struct input_dev or NULL.
+ *
+ * NOTE: Use input_free_device() to free devices that have not been
+ * registered; input_unregister_device() should be used for already
+ * registered devices.
+ */
 struct input_dev *input_allocate_device(void)
 {
 	struct input_dev *dev;
@@ -919,6 +928,20 @@ struct input_dev *input_allocate_device(void)
 }
 EXPORT_SYMBOL(input_allocate_device);
 
+/**
+ * input_free_device - free memory occupied by input_dev structure
+ * @dev: input device to free
+ *
+ * This function should only be used if input_register_device()
+ * was not called yet or if it failed. Once device was registered
+ * use input_unregister_device() and memory will be freed once last
+ * refrence to the device is dropped.
+ *
+ * Device should be allocated by input_allocate_device().
+ *
+ * NOTE: If there are references to the input device then memory
+ * will not be freed until last reference is dropped.
+ */
 void input_free_device(struct input_dev *dev)
 {
 	if (dev) {