Improvements to SetSampleMaterial

This was originally [trac #9978](http://trac.mantidproject.org/mantid/ticket/9978).

**To test:** Look at the new documentation and see if it addresses Spencer's questions/comments.