tidied up intro listing of parameters