Improve shutdown behaviour of controller
Improve shutdown behaviour of controller

Minor modifications to ensure clean shutdown behaviour of the controller
at the end of the run() method, and to explicitly signal to the reactor
to terminate, rather than replying on the EINTR behaviour of the
underlying ZMQ elements.

Also more method documentation added.
percival-detector/odin-data,percival-detector/odin-data,odin-detector/odin-data,percival-detector/odin-data,odin-detector/odin-data,percival-detector/odin-data,odin-detector/odin-data,odin-detector/odin-data,percival-detector/odin-data,odin-detector/odin-data,odin-detector/odin-data,percival-detector/odin-data,odin-detector/odin-data,percival-detector/odin-data