raise exception for invalid selection strings, update docs