some cleanups, and readme.
add note about stack traces.
some comments.