last fixes and documentation for release

manual page updates and improvements to kdf argument handling