edits for clarity, added proxy_gen.sh to tools
added a few more inline comments for clarity
some minor cleanup