tidied up comments in new optimisation functions