more docs, use bools for clamping, merge remove and remove_nth