Without this patch, Sphinx shows "variable arguments" as the description of the cond argument, rather than the intended description, and prints the following warnings: ./include/linux/rculist.h:374: warning: Excess function parameter 'cond' description in 'list_for_each_entry_rcu' ./include/linux/rculist.h:651: warning: Excess function parameter 'cond' description in 'hlist_for_each_entry_rcu'
Showing the changes to include/linux (1 of 1 file). Show all
Unified · Split
| @@ -361,7 +361,7 @@ static inline void list_splice_tail_init_rcu(struct list_head *list, · 360 unmodified lines | |||
| 361 | * @pos: the type * to use as a loop cursor. | 361 | * @pos: the type * to use as a loop cursor. |
| 362 | * @head: the head for your list. | 362 | * @head: the head for your list. |
| 363 | * @member: the name of the list_head within the struct. | 363 | * @member: the name of the list_head within the struct. |
| 364 | * @cond: optional lockdep expression if called from non-RCU protection. | 364 | * @cond...: optional lockdep expression if called from non-RCU protection. |
| 365 | * | 365 | * |
| 366 | * This list-traversal primitive may safely run concurrently with | 366 | * This list-traversal primitive may safely run concurrently with |
| 367 | * the _rcu list-mutation primitives such as list_add_rcu() | 367 | * the _rcu list-mutation primitives such as list_add_rcu() |
| @@ -636,7 +636,7 @@ static inline void hlist_add_behind_rcu(struct hlist_node *n, · 268 unmodified lines | |||
| 636 | * @pos: the type * to use as a loop cursor. | 636 | * @pos: the type * to use as a loop cursor. |
| 637 | * @head: the head for your list. | 637 | * @head: the head for your list. |
| 638 | * @member: the name of the hlist_node within the struct. | 638 | * @member: the name of the hlist_node within the struct. |
| 639 | * @cond: optional lockdep expression if called from non-RCU protection. | 639 | * @cond...: optional lockdep expression if called from non-RCU protection. |
| 640 | * | 640 | * |
| 641 | * This list-traversal primitive may safely run concurrently with | 641 | * This list-traversal primitive may safely run concurrently with |
| 642 | * the _rcu list-mutation primitives such as hlist_add_head_rcu() | 642 | * the _rcu list-mutation primitives such as hlist_add_head_rcu() |