FIX: compiler warnings in clang
FIX: clang compiler flags
remove debugging tool
documentation