Add documentation for more convenience constructors

Also rename arguments in initialiser to be in line with constructors.