add tuple manipulation helper classes
clarify doc