Adds a mechanism (which was added to KafkaEventStreamDecoder
incorrectly) to print the exception to help flush out our flakey tests.

See commit 92455e43 - which is the same changes in
KafkaEventStreamDecoderTest for details

Removes all of the from __future__ imports that open and close the
brackets on the same line. This is most of them.

as there is some strange interplay between datasearch.directories and defaultsave

Haven't changed AlgorithmProxy as that class will be deleted in the next PR

This function returns a bool which was previously being used to indicate two separate things. The return values could mean:
  * False: Either the workspace does not exist on the axis or it does but the axis is not empty after its' removal.
  * True: Workspace exists and was removed and axis is now empty

This made the value not very useful for determining whether a call to remove_workspace_artists had removed anything. A grep of the code base returned that this return value was not currently being used anywhere except in MantidAxes.cpp where it was assumed to indicate whether anything had been removed. As you can easily check whether an axis is empty by other means I have changed the return value so that it indicates whether the call resulted in any change to the plot which is harder to divine by other means and brings this function in line with replace_workspace_artist.

and fix a unit test for not having a list limit

Ensure CommonUBForAll cannot be used if there are peaks from only one run present.

Miscellaneous code review comments to add comments, remove redundant brackets
Also added comment to the sample environment concept page to explain where
Mantid will search for the attenuation profile file