idr: describe how nextidp works in idr_get_next().
authorNaohiro Aota <naota@elisp.net>
Fri, 27 Aug 2010 08:43:46 +0000 (17:43 +0900)
committerJiri Kosina <jkosina@suse.cz>
Tue, 31 Aug 2010 07:43:59 +0000 (09:43 +0200)
It was unclear in original kernel-doc how nextidp worked in
idr_get_next(). Let's describe it.

Signed-off-by: Naohiro Aota <naota@elisp.net>
Acked-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
lib/idr.c

index fb86a67..5e0966b 100644 (file)
--- a/lib/idr.c
+++ b/lib/idr.c
@@ -589,7 +589,8 @@ EXPORT_SYMBOL(idr_for_each);
  * @nextidp:  pointer to lookup key
  *
  * Returns pointer to registered object with id, which is next number to
- * given id.
+ * given id. After being looked up, *@nextidp will be updated for the next
+ * iteration.
  */
 
 void *idr_get_next(struct idr *idp, int *nextidp)