rb_tree: add augmentation comments

Add comments to better explain why augmentation is done in several places.
Reviewed by: alc
MFC after: 2 weeks
Differential Revision: https://reviews.freebsd.org/D36646

(cherry picked from commit b5b07c71e83637af8a2507ef96c32bc7e2d226c6)