clang compilation and runtime fixes
added minimal README file