augmented rbtree: add comments for RB_DECLARE_CALLBACKS macro

Patch series "make RB_DECLARE_CALLBACKS more generic", v3.

These changes are intended to make the RB_DECLARE_CALLBACKS macro more
generic (allowing the aubmented subtree information to be a struct instead
of a scalar).

I have verified the compiled lib/interval_tree.o and mm/mmap.o files to
check that they didn't change.  This held as expected for interval_tree.o;
mmap.o did have some changes which could be reverted by marking
__vma_link_rb as noinline.  I did not add such a change to the patchset; I
felt it was reasonable enough to leave the inlining decision up to the

This patch (of 3):

Add a short comment summarizing the arguments to RB_DECLARE_CALLBACKS. 
The arguments are also now capitalized.  This copies the style of the

No functional changes in this commit, only comments and capitalization.

Signed-off-by: Michel Lespinasse <>
Acked-by: Davidlohr Bueso <>
Acked-by: Peter Zijlstra (Intel) <>
Cc: David Howells <>
Cc: Uladzislau Rezki <>
Signed-off-by: Andrew Morton <>
2 files changed