updated to document use of sequences of two-element tuples as inputs