Updated README, plus cleaned up warnings, fixed errors in comments.