update dokumentation and examples for exported functions