further documentation and minor changes