* [PATCH 2/2] list.h doc: change "counter" to "control"
@ 2006-05-18 17:54 Randy.Dunlap
[not found] ` <7b69d1470605190837o44f2c0f5o4aa9faa421dfb3f7@mail.gmail.com>
0 siblings, 1 reply; 4+ messages in thread
From: Randy.Dunlap @ 2006-05-18 17:54 UTC (permalink / raw)
To: lkml; +Cc: akpm
From: Randy Dunlap <rdunlap@xenotime.net>
Use loop "control" instead of loop "counter" for list iterator
descriptions. They are not counters, they are controls or
pointers or positions.
Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
---
include/linux/list.h | 52 +++++++++++++++++++++++++--------------------------
1 files changed, 26 insertions(+), 26 deletions(-)
--- linux-2617-rc4g6.orig/include/linux/list.h
+++ linux-2617-rc4g6/include/linux/list.h
@@ -328,7 +328,7 @@ static inline void list_splice_init(stru
/**
* list_for_each - iterate over a list
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @head: the head for your list.
*/
#define list_for_each(pos, head) \
@@ -337,7 +337,7 @@ static inline void list_splice_init(stru
/**
* __list_for_each - iterate over a list
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @head: the head for your list.
*
* This variant differs from list_for_each() in that it's the
@@ -350,7 +350,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_prev - iterate over a list backwards
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @head: the head for your list.
*/
#define list_for_each_prev(pos, head) \
@@ -359,7 +359,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_safe - iterate over a list safe against removal of list entry
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @n: another &struct list_head to use as temporary storage
* @head: the head for your list.
*/
@@ -369,7 +369,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry - iterate over list of given type
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*/
@@ -380,7 +380,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_reverse - iterate backwards over list of given type.
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*/
@@ -402,7 +402,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_continue - continue iteration over list of given type
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*
@@ -416,7 +416,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_from - iterate over list of given type from the current point
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*
@@ -428,7 +428,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe - iterate over list of given type safe against removal of list entry
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -441,7 +441,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe_continue
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -457,7 +457,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe_from
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -472,7 +472,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe_reverse
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -488,7 +488,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_rcu - iterate over an rcu-protected list
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @head: the head for your list.
*
* This list-traversal primitive may safely run concurrently with
@@ -507,7 +507,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_safe_rcu
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @n: another &struct list_head to use as temporary storage
* @head: the head for your list.
*
@@ -524,7 +524,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_rcu - iterate over rcu list of given type
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop control.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*
@@ -541,7 +541,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_continue_rcu
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop control.
* @head: the head for your list.
*
* Iterate over an rcu-protected list, continuing after current point.
@@ -791,8 +791,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry - iterate over list of given type
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop control.
+ * @pos: the &struct hlist_node to use as a loop control.
* @head: the head for your list.
* @member: the name of the hlist_node within the struct.
*/
@@ -804,8 +804,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_continue - iterate over a hlist continuing after current point
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop control.
+ * @pos: the &struct hlist_node to use as a loop control.
* @member: the name of the hlist_node within the struct.
*/
#define hlist_for_each_entry_continue(tpos, pos, member) \
@@ -816,8 +816,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_from - iterate over a hlist continuing from current point
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop control.
+ * @pos: the &struct hlist_node to use as a loop control.
* @member: the name of the hlist_node within the struct.
*/
#define hlist_for_each_entry_from(tpos, pos, member) \
@@ -827,8 +827,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_safe - iterate over list of given type safe against removal of list entry
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop control.
+ * @pos: the &struct hlist_node to use as a loop control.
* @n: another &struct hlist_node to use as temporary storage
* @head: the head for your list.
* @member: the name of the hlist_node within the struct.
@@ -841,8 +841,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_rcu - iterate over rcu list of given type
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop control.
+ * @pos: the &struct hlist_node to use as a loop control.
* @head: the head for your list.
* @member: the name of the hlist_node within the struct.
*
---
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 2/2] list.h doc: change "counter" to "control"
[not found] ` <7b69d1470605190837o44f2c0f5o4aa9faa421dfb3f7@mail.gmail.com>
@ 2006-05-19 16:02 ` Randy.Dunlap
2006-05-19 16:05 ` Andrew Morton
0 siblings, 1 reply; 4+ messages in thread
From: Randy.Dunlap @ 2006-05-19 16:02 UTC (permalink / raw)
To: Scott Preece; +Cc: linux-kernel, akpm
On Fri, 19 May 2006 10:37:28 -0500 Scott Preece wrote:
> I agree that "counter" is wrong, but "control" is still a little
> vague. How about:
> "the &struct list_head that tracks iteration over the list" or
> "the &struct list_head that tracks current location in list."
I considered "iterator" (but that's the macro itself I think),
"control", "variable", "pointer", and "position".
"current location" would be OK with me.
> scott
>
> On 5/18/06, Randy.Dunlap <rdunlap@xenotime.net> wrote:
> > From: Randy Dunlap <rdunlap@xenotime.net>
> >
> > Use loop "control" instead of loop "counter" for list iterator
> > descriptions. They are not counters, they are controls or
> > pointers or positions.
> >
> > Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
> > ---
> > include/linux/list.h | 52 +++++++++++++++++++++++++--------------------------
> > 1 files changed, 26 insertions(+), 26 deletions(-)
> >
> > --- linux-2617-rc4g6.orig/include/linux/list.h
> > +++ linux-2617-rc4g6/include/linux/list.h
> > @@ -328,7 +328,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each - iterate over a list
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @head: the head for your list.
> > */
> > #define list_for_each(pos, head) \
> > @@ -337,7 +337,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * __list_for_each - iterate over a list
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @head: the head for your list.
> > *
> > * This variant differs from list_for_each() in that it's the
> > @@ -350,7 +350,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_prev - iterate over a list backwards
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @head: the head for your list.
> > */
> > #define list_for_each_prev(pos, head) \
> > @@ -359,7 +359,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_safe - iterate over a list safe against removal of list entry
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @n: another &struct list_head to use as temporary storage
> > * @head: the head for your list.
> > */
> > @@ -369,7 +369,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry - iterate over list of given type
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > */
> > @@ -380,7 +380,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_reverse - iterate backwards over list of given type.
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > */
> > @@ -402,7 +402,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_continue - continue iteration over list of given type
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > *
> > @@ -416,7 +416,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_from - iterate over list of given type from the current point
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > *
> > @@ -428,7 +428,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_safe - iterate over list of given type safe against removal of list entry
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @n: another type * to use as temporary storage
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > @@ -441,7 +441,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_safe_continue
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @n: another type * to use as temporary storage
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > @@ -457,7 +457,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_safe_from
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @n: another type * to use as temporary storage
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > @@ -472,7 +472,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_safe_reverse
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @n: another type * to use as temporary storage
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > @@ -488,7 +488,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_rcu - iterate over an rcu-protected list
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @head: the head for your list.
> > *
> > * This list-traversal primitive may safely run concurrently with
> > @@ -507,7 +507,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_safe_rcu
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @n: another &struct list_head to use as temporary storage
> > * @head: the head for your list.
> > *
> > @@ -524,7 +524,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_entry_rcu - iterate over rcu list of given type
> > - * @pos: the type * to use as a loop counter.
> > + * @pos: the type * to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the list_struct within the struct.
> > *
> > @@ -541,7 +541,7 @@ static inline void list_splice_init(stru
> >
> > /**
> > * list_for_each_continue_rcu
> > - * @pos: the &struct list_head to use as a loop counter.
> > + * @pos: the &struct list_head to use as a loop control.
> > * @head: the head for your list.
> > *
> > * Iterate over an rcu-protected list, continuing after current point.
> > @@ -791,8 +791,8 @@ static inline void hlist_add_after_rcu(s
> >
> > /**
> > * hlist_for_each_entry - iterate over list of given type
> > - * @tpos: the type * to use as a loop counter.
> > - * @pos: the &struct hlist_node to use as a loop counter.
> > + * @tpos: the type * to use as a loop control.
> > + * @pos: the &struct hlist_node to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the hlist_node within the struct.
> > */
> > @@ -804,8 +804,8 @@ static inline void hlist_add_after_rcu(s
> >
> > /**
> > * hlist_for_each_entry_continue - iterate over a hlist continuing after current point
> > - * @tpos: the type * to use as a loop counter.
> > - * @pos: the &struct hlist_node to use as a loop counter.
> > + * @tpos: the type * to use as a loop control.
> > + * @pos: the &struct hlist_node to use as a loop control.
> > * @member: the name of the hlist_node within the struct.
> > */
> > #define hlist_for_each_entry_continue(tpos, pos, member) \
> > @@ -816,8 +816,8 @@ static inline void hlist_add_after_rcu(s
> >
> > /**
> > * hlist_for_each_entry_from - iterate over a hlist continuing from current point
> > - * @tpos: the type * to use as a loop counter.
> > - * @pos: the &struct hlist_node to use as a loop counter.
> > + * @tpos: the type * to use as a loop control.
> > + * @pos: the &struct hlist_node to use as a loop control.
> > * @member: the name of the hlist_node within the struct.
> > */
> > #define hlist_for_each_entry_from(tpos, pos, member) \
> > @@ -827,8 +827,8 @@ static inline void hlist_add_after_rcu(s
> >
> > /**
> > * hlist_for_each_entry_safe - iterate over list of given type safe against removal of list entry
> > - * @tpos: the type * to use as a loop counter.
> > - * @pos: the &struct hlist_node to use as a loop counter.
> > + * @tpos: the type * to use as a loop control.
> > + * @pos: the &struct hlist_node to use as a loop control.
> > * @n: another &struct hlist_node to use as temporary storage
> > * @head: the head for your list.
> > * @member: the name of the hlist_node within the struct.
> > @@ -841,8 +841,8 @@ static inline void hlist_add_after_rcu(s
> >
> > /**
> > * hlist_for_each_entry_rcu - iterate over rcu list of given type
> > - * @tpos: the type * to use as a loop counter.
> > - * @pos: the &struct hlist_node to use as a loop counter.
> > + * @tpos: the type * to use as a loop control.
> > + * @pos: the &struct hlist_node to use as a loop control.
> > * @head: the head for your list.
> > * @member: the name of the hlist_node within the struct.
> > *
> >
> >
> > ---
> > -
> > To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> > the body of a message to majordomo@vger.kernel.org
> > More majordomo info at http://vger.kernel.org/majordomo-info.html
> > Please read the FAQ at http://www.tux.org/lkml/
> >
>
---
~Randy
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 2/2] list.h doc: change "counter" to "control"
2006-05-19 16:02 ` Randy.Dunlap
@ 2006-05-19 16:05 ` Andrew Morton
[not found] ` <7b69d1470605191010o37b5aafeud18263214519456a@mail.gmail.com>
0 siblings, 1 reply; 4+ messages in thread
From: Andrew Morton @ 2006-05-19 16:05 UTC (permalink / raw)
To: Randy.Dunlap; +Cc: sepreece, linux-kernel
"Randy.Dunlap" <rdunlap@xenotime.net> wrote:
>
> On Fri, 19 May 2006 10:37:28 -0500 Scott Preece wrote:
>
> > I agree that "counter" is wrong, but "control" is still a little
> > vague. How about:
> > "the &struct list_head that tracks iteration over the list" or
> > "the &struct list_head that tracks current location in list."
>
> I considered "iterator" (but that's the macro itself I think),
> "control", "variable", "pointer", and "position".
> "current location" would be OK with me.
"cursor"
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 2/2] list.h doc: change "counter" to "control"
[not found] ` <7b69d1470605191010o37b5aafeud18263214519456a@mail.gmail.com>
@ 2006-05-19 17:27 ` Randy.Dunlap
0 siblings, 0 replies; 4+ messages in thread
From: Randy.Dunlap @ 2006-05-19 17:27 UTC (permalink / raw)
To: Scott Preece; +Cc: akpm, linux-kernel
On Fri, 19 May 2006 12:10:12 -0500 Scott Preece wrote:
> "cursor" is what I usually use in my own code...
>
> On 5/19/06, Andrew Morton <akpm@osdl.org> wrote:
> >
> > "cursor"
OK, here's a patch to replace the other one.
From: Randy Dunlap <rdunlap@xenotime.net>
Use loop "cursor" instead of loop "counter" for list iterator
descriptions. They are not counters, they are cursors or
pointers or positions or locations.
Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
---
include/linux/list.h | 52 +++++++++++++++++++++++++--------------------------
1 files changed, 26 insertions(+), 26 deletions(-)
--- linux-2617-rc4g6.orig/include/linux/list.h
+++ linux-2617-rc4g6/include/linux/list.h
@@ -328,7 +328,7 @@ static inline void list_splice_init(stru
/**
* list_for_each - iterate over a list
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @head: the head for your list.
*/
#define list_for_each(pos, head) \
@@ -337,7 +337,7 @@ static inline void list_splice_init(stru
/**
* __list_for_each - iterate over a list
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @head: the head for your list.
*
* This variant differs from list_for_each() in that it's the
@@ -350,7 +350,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_prev - iterate over a list backwards
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @head: the head for your list.
*/
#define list_for_each_prev(pos, head) \
@@ -359,7 +359,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_safe - iterate over a list safe against removal of list entry
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @n: another &struct list_head to use as temporary storage
* @head: the head for your list.
*/
@@ -369,7 +369,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry - iterate over list of given type
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*/
@@ -380,7 +380,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_reverse - iterate backwards over list of given type.
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*/
@@ -402,7 +402,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_continue - continue iteration over list of given type
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*
@@ -416,7 +416,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_from - iterate over list of given type from the current point
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*
@@ -428,7 +428,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe - iterate over list of given type safe against removal of list entry
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -441,7 +441,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe_continue
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -457,7 +457,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe_from
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -472,7 +472,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_safe_reverse
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @n: another type * to use as temporary storage
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
@@ -488,7 +488,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_rcu - iterate over an rcu-protected list
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @head: the head for your list.
*
* This list-traversal primitive may safely run concurrently with
@@ -507,7 +507,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_safe_rcu
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @n: another &struct list_head to use as temporary storage
* @head: the head for your list.
*
@@ -524,7 +524,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_entry_rcu - iterate over rcu list of given type
- * @pos: the type * to use as a loop counter.
+ * @pos: the type * to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the list_struct within the struct.
*
@@ -541,7 +541,7 @@ static inline void list_splice_init(stru
/**
* list_for_each_continue_rcu
- * @pos: the &struct list_head to use as a loop counter.
+ * @pos: the &struct list_head to use as a loop cursor.
* @head: the head for your list.
*
* Iterate over an rcu-protected list, continuing after current point.
@@ -791,8 +791,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry - iterate over list of given type
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop cursor.
+ * @pos: the &struct hlist_node to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the hlist_node within the struct.
*/
@@ -804,8 +804,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_continue - iterate over a hlist continuing after current point
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop cursor.
+ * @pos: the &struct hlist_node to use as a loop cursor.
* @member: the name of the hlist_node within the struct.
*/
#define hlist_for_each_entry_continue(tpos, pos, member) \
@@ -816,8 +816,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_from - iterate over a hlist continuing from current point
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop cursor.
+ * @pos: the &struct hlist_node to use as a loop cursor.
* @member: the name of the hlist_node within the struct.
*/
#define hlist_for_each_entry_from(tpos, pos, member) \
@@ -827,8 +827,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_safe - iterate over list of given type safe against removal of list entry
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop cursor.
+ * @pos: the &struct hlist_node to use as a loop cursor.
* @n: another &struct hlist_node to use as temporary storage
* @head: the head for your list.
* @member: the name of the hlist_node within the struct.
@@ -841,8 +841,8 @@ static inline void hlist_add_after_rcu(s
/**
* hlist_for_each_entry_rcu - iterate over rcu list of given type
- * @tpos: the type * to use as a loop counter.
- * @pos: the &struct hlist_node to use as a loop counter.
+ * @tpos: the type * to use as a loop cursor.
+ * @pos: the &struct hlist_node to use as a loop cursor.
* @head: the head for your list.
* @member: the name of the hlist_node within the struct.
*
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2006-05-19 17:25 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2006-05-18 17:54 [PATCH 2/2] list.h doc: change "counter" to "control" Randy.Dunlap
[not found] ` <7b69d1470605190837o44f2c0f5o4aa9faa421dfb3f7@mail.gmail.com>
2006-05-19 16:02 ` Randy.Dunlap
2006-05-19 16:05 ` Andrew Morton
[not found] ` <7b69d1470605191010o37b5aafeud18263214519456a@mail.gmail.com>
2006-05-19 17:27 ` Randy.Dunlap
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®