documented the pair function; updated bard version