cleanup

documentation in headers improved