DOC: expand the documentation on the xs method

closes #4900