updates to the manual page (still to be extended).