rename path argument and tidy up documentation