several improvements in dokumentation and code