add improved comment back in from Tommy
release 1.1.1