partial tidy up of foxetal2014 docstring.