DOC: expand the documentation on the xs method