Update comments and take one more crack at fixing the readme.