DOC: update DataFrame.xs docstring and add examples
Update of DataFrame.xs docstring.
Added some examples also, maybe too verbose? 

This looks good to me. Cherry-picked the commit and am leaving #1796 open
