Pull request for fixes / documentation edits related to the profiles 

This is the documentation / fixes proposed for the pull request to deal with the density profiles. 

This is already rebased to master - so should be good to merge provided that @mklauser is happy.

Making request direct to master (rather than to pull request) because the automatic merge wouldn't work otherwise. For unclear reasons!